home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: LaTeX Document
(document/latex).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| LaTeX Document (document/latex)
| magic
| Supported |
| 1%
| dexvert
| Corel 10 Texture (image/corel10Texture)
| ext
| Unsupported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| LaTeX document text
| default
| |
| 99%
| file
| C source text
| default
| |
| 98%
| file
| C source, ASCII text
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/281 LaTeX (Subdocument)
| default
| |
| 100%
| detectItEasy
| Format: Plain text[LF]
| default
| |
| 100%
| xdgMime
| text/x-matlab
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 25 20 2d 2a 2d 20 4c 61 | 54 65 58 20 2d 2a 2d 0a |% -*- La|TeX -*-.|
|00000010| 5c 63 68 61 70 74 65 72 | 20 7b 4d 65 73 73 61 67 |\chapter| {Messag|
|00000020| 65 20 53 75 62 6d 69 73 | 73 69 6f 6e 7d 0a 0a 5c |e Submis|sion}..\|
|00000030| 73 65 63 74 69 6f 6e 20 | 7b 4f 76 65 72 76 69 65 |section |{Overvie|
|00000040| 77 7d 0a 0a 54 68 69 73 | 20 63 68 61 70 74 65 72 |w}..This| chapter|
|00000050| 20 64 65 73 63 72 69 62 | 65 73 20 74 68 65 20 70 | describ|es the p|
|00000060| 72 6f 63 65 64 75 72 61 | 6c 20 69 6e 74 65 72 66 |rocedura|l interf|
|00000070| 61 63 65 20 66 6f 72 20 | 6d 65 73 73 61 67 65 0a |ace for |message.|
|00000080| 73 75 62 6d 69 73 73 69 | 6f 6e 2e 20 20 54 68 69 |submissi|on. Thi|
|00000090| 73 20 69 6e 74 65 72 66 | 61 63 65 20 72 65 66 6c |s interf|ace refl|
|000000a0| 65 63 74 73 20 74 68 65 | 20 73 75 62 6d 69 73 73 |ects the| submiss|
|000000b0| 69 6f 6e 20 69 6e 74 65 | 72 66 61 63 65 20 6f 66 |ion inte|rface of|
|000000c0| 20 62 6f 74 68 0a 74 68 | 65 20 6d 65 73 73 61 67 | both.th|e messag|
|000000d0| 65 20 74 72 61 6e 73 66 | 65 72 20 61 62 73 74 72 |e transf|er abstr|
|000000e0| 61 63 74 20 73 65 72 76 | 69 63 65 20 61 6e 64 20 |act serv|ice and |
|000000f0| 74 68 65 20 4d 54 41 20 | 61 62 73 74 72 61 63 74 |the MTA |abstract|
|00000100| 20 73 65 72 76 69 63 65 | 2e 0a 49 74 20 69 73 20 | service|..It is |
|00000110| 74 68 65 72 65 66 6f 72 | 65 20 75 73 65 64 20 66 |therefor|e used f|
|00000120| 6f 72 3a 0a 0a 5c 62 65 | 67 69 6e 7b 69 74 65 6d |or:..\be|gin{item|
|00000130| 69 7a 65 7d 0a 5c 69 74 | 65 6d 20 55 73 65 72 20 |ize}.\it|em User |
|00000140| 69 6e 74 65 72 66 61 63 | 65 73 20 73 75 62 6d 69 |interfac|es submi|
|00000150| 74 74 69 6e 67 20 6d 65 | 73 73 61 67 65 73 20 28 |tting me|ssages (|
|00000160| 6d 65 73 73 61 67 65 20 | 74 72 61 6e 73 66 65 72 |message |transfer|
|00000170| 20 61 62 73 74 72 61 63 | 74 0a 73 65 72 76 69 63 | abstrac|t.servic|
|00000180| 65 29 2e 0a 0a 5c 69 74 | 65 6d 20 49 6e 62 6f 75 |e)...\it|em Inbou|
|00000190| 6e 64 20 63 68 61 6e 6e | 65 6c 73 20 73 75 62 6d |nd chann|els subm|
|000001a0| 69 74 74 69 6e 67 20 6d | 65 73 73 61 67 65 73 20 |itting m|essages |
|000001b0| 28 4d 54 41 20 61 62 73 | 74 72 61 63 74 20 73 65 |(MTA abs|tract se|
|000001c0| 72 76 69 63 65 29 2e 0a | 5c 65 6e 64 7b 69 74 65 |rvice)..|\end{ite|
|000001d0| 6d 69 7a 65 7d 0a 0a 49 | 74 20 69 73 20 61 20 67 |mize}..I|t is a g|
|000001e0| 65 6e 65 72 61 6c 69 73 | 65 64 20 69 6e 74 65 72 |eneralis|ed inter|
|000001f0| 66 61 63 65 2c 20 77 69 | 74 68 20 61 73 70 65 63 |face, wi|th aspec|
|00000200| 74 73 20 62 65 79 6f 6e | 64 20 58 2e 34 30 30 2c |ts beyon|d X.400,|
|00000210| 20 62 75 74 20 69 74 20 | 69 73 0a 62 72 6f 61 64 | but it |is.broad|
|00000220| 6c 79 20 74 61 72 67 65 | 74 65 64 20 66 6f 72 20 |ly targe|ted for |
|00000230| 58 2e 34 30 30 20 75 73 | 61 67 65 2e 20 20 54 68 |X.400 us|age. Th|
|00000240| 65 20 67 65 6e 65 72 61 | 6c 20 66 75 6e 63 74 69 |e genera|l functi|
|00000250| 6f 6e 20 6f 66 20 74 68 | 65 0a 69 6e 74 65 72 66 |on of th|e.interf|
|00000260| 61 63 65 20 69 73 20 61 | 73 20 66 6f 6c 6c 6f 77 |ace is a|s follow|
|00000270| 73 3a 0a 0a 5c 62 65 67 | 69 6e 7b 65 6e 75 6d 65 |s:..\beg|in{enume|
|00000280| 72 61 74 65 7d 5c 69 6e | 64 65 78 7b 73 75 62 6d |rate}\in|dex{subm|
|00000290| 69 74 20 70 72 6f 74 6f | 63 6f 6c 7d 0a 5c 69 74 |it proto|col}.\it|
|000002a0| 65 6d 20 49 6e 69 74 69 | 61 6c 69 73 65 20 73 75 |em Initi|alise su|
|000002b0| 62 6d 69 73 73 69 6f 6e | 2e 0a 0a 5c 69 74 65 6d |bmission|...\item|
|000002c0| 20 49 6e 69 74 69 61 6c | 69 73 65 20 4d 65 73 73 | Initial|ise Mess|
|000002d0| 61 67 65 20 28 70 65 72 | 2d 6d 65 73 73 61 67 65 |age (per|-message|
|000002e0| 20 70 61 72 61 6d 65 74 | 65 72 73 29 2e 0a 0a 5c | paramet|ers)...\|
|000002f0| 69 74 65 6d 20 48 61 6e | 64 73 68 61 6b 65 20 6f |item Han|dshake o|
|00000300| 6e 20 61 64 64 72 65 73 | 73 65 73 2e 0a 0a 5c 69 |n addres|ses...\i|
|00000310| 74 65 6d 20 54 72 61 6e | 73 66 65 72 20 6f 6e 65 |tem Tran|sfer one|
|00000320| 20 6f 72 20 6d 6f 72 65 | 20 62 6f 64 79 20 70 61 | or more| body pa|
|00000330| 72 74 73 2e 0a 0a 5c 69 | 74 65 6d 20 46 69 6e 61 |rts...\i|tem Fina|
|00000340| 6c 20 68 61 6e 64 73 68 | 61 6b 65 20 74 6f 20 6c |l handsh|ake to l|
|00000350| 6f 63 6b 20 6d 65 73 73 | 61 67 65 20 69 6e 74 6f |ock mess|age into|
|00000360| 20 74 68 65 20 71 75 65 | 75 65 20 6f 72 20 61 62 | the que|ue or ab|
|00000370| 6f 72 74 2e 0a 0a 5c 69 | 74 65 6d 20 47 6f 74 6f |ort...\i|tem Goto|
|00000380| 20 32 2c 20 75 6e 74 69 | 6c 20 6e 6f 20 6d 6f 72 | 2, unti|l no mor|
|00000390| 65 20 6d 65 73 73 61 67 | 65 73 2e 0a 0a 5c 69 74 |e messag|es...\it|
|000003a0| 65 6d 20 54 65 72 6d 69 | 6e 61 74 65 20 73 75 62 |em Termi|nate sub|
|000003b0| 6d 69 73 73 69 6f 6e 2e | 0a 5c 65 6e 64 7b 65 6e |mission.|.\end{en|
|000003c0| 75 6d 65 72 61 74 65 7d | 0a 0a 5c 73 65 63 74 69 |umerate}|..\secti|
|000003d0| 6f 6e 20 7b 54 68 65 20 | 69 6f 5c 5f 20 49 6e 74 |on {The |io\_ Int|
|000003e0| 65 72 66 61 63 65 7d 0a | 0a 54 68 65 20 5c 76 65 |erface}.|.The \ve|
|000003f0| 72 62 7c 69 6f 5f 7c 20 | 69 6e 74 65 72 66 61 63 |rb|io_| |interfac|
|00000400| 65 20 69 73 20 74 68 65 | 20 66 75 6c 6c 20 69 6e |e is the| full in|
|00000410| 74 65 72 66 61 63 65 20 | 74 6f 20 50 50 2e 20 41 |terface |to PP. A|
|00000420| 6c 6c 20 72 6f 75 74 69 | 6e 65 73 0a 68 61 76 65 |ll routi|nes.have|
|00000430| 20 74 68 65 20 70 72 65 | 66 69 78 20 5c 76 65 72 | the pre|fix \ver|
|00000440| 62 7c 69 6f 5f 7c 20 61 | 6e 64 20 61 6c 6c 20 72 |b|io_| a|nd all r|
|00000450| 65 74 75 72 6e 20 73 6f | 6d 65 20 74 79 70 65 20 |eturn so|me type |
|00000460| 6f 66 20 73 74 61 74 75 | 73 0a 69 6e 64 69 63 61 |of statu|s.indica|
|00000470| 74 69 6e 67 20 73 75 63 | 63 65 73 73 20 6f 72 20 |ting suc|cess or |
|00000480| 66 61 69 6c 75 72 65 2e | 0a 0a 5c 73 75 62 73 65 |failure.|..\subse|
|00000490| 63 74 69 6f 6e 20 7b 4d | 61 6a 6f 72 20 53 74 72 |ction {M|ajor Str|
|000004a0| 75 63 74 75 72 65 73 7d | 0a 0a 54 68 65 20 66 6f |uctures}|..The fo|
|000004b0| 6c 6c 6f 77 69 6e 67 20 | 61 72 65 20 74 68 65 20 |llowing |are the |
|000004c0| 6b 65 79 20 73 74 72 75 | 63 74 75 72 65 73 20 75 |key stru|ctures u|
|000004d0| 73 65 64 20 69 6e 20 73 | 75 62 6d 69 73 73 69 6f |sed in s|ubmissio|
|000004e0| 6e 2e 20 54 68 65 73 65 | 0a 73 74 72 75 63 74 75 |n. These|.structu|
|000004f0| 72 65 73 20 73 68 6f 75 | 6c 64 20 62 65 20 66 69 |res shou|ld be fi|
|00000500| 6c 6c 65 64 20 69 6e 20 | 61 6e 64 20 70 61 73 73 |lled in |and pass|
|00000510| 65 64 20 6f 76 65 72 20 | 74 6f 20 5c 70 67 6d 7b |ed over |to \pgm{|
|00000520| 73 75 62 6d 69 74 7d 20 | 62 79 20 74 68 65 0a 70 |submit} |by the.p|
|00000530| 72 6f 63 65 64 75 72 65 | 73 20 64 65 66 69 6e 65 |rocedure|s define|
|00000540| 64 20 62 65 6c 6f 77 2e | 0a 0a 5c 73 75 62 73 75 |d below.|..\subsu|
|00000550| 62 73 65 63 74 69 6f 6e | 7b 43 68 61 6e 6e 65 6c |bsection|{Channel|
|00000560| 20 4c 69 73 74 73 7d 0a | 0a 41 20 63 68 61 6e 6e | Lists}.|.A chann|
|00000570| 65 6c 20 6c 69 73 74 20 | 69 73 20 74 68 65 20 73 |el list |is the s|
|00000580| 74 72 75 63 74 75 72 65 | 20 75 73 65 64 20 74 6f |tructure| used to|
|00000590| 20 6b 65 65 70 20 63 68 | 61 6e 6e 65 6c 73 20 61 | keep ch|annels a|
|000005a0| 6e 64 20 68 6f 73 74 73 | 2e 20 49 74 20 69 73 0a |nd hosts|. It is.|
|000005b0| 64 65 66 69 6e 65 64 20 | 69 6e 20 66 69 6c 65 20 |defined |in file |
|000005c0| 5c 66 69 6c 65 7b 6c 69 | 73 74 5c 5f 72 63 68 61 |\file{li|st\_rcha|
|000005d0| 6e 2e 68 7d 20 61 6e 64 | 20 74 68 65 20 73 74 72 |n.h} and| the str|
|000005e0| 75 63 74 75 72 65 20 69 | 73 20 73 68 6f 77 6e 20 |ucture i|s shown |
|000005f0| 69 6e 0a 46 69 67 75 72 | 65 7e 5c 72 65 66 7b 72 |in.Figur|e~\ref{r|
|00000600| 63 68 61 6e 3a 73 74 72 | 75 63 74 7d 0a 0a 5c 74 |chan:str|uct}..\t|
|00000610| 61 67 72 69 6e 64 5b 68 | 62 74 70 5d 7b 72 63 68 |agrind[h|btp]{rch|
|00000620| 61 6e 7d 7b 43 68 61 6e | 6e 65 6c 20 4c 69 73 74 |an}{Chan|nel List|
|00000630| 20 53 74 72 75 63 74 75 | 72 65 7d 7b 72 63 68 61 | Structu|re}{rcha|
|00000640| 6e 3a 73 74 72 75 63 74 | 7d 0a 5c 69 6e 64 65 78 |n:struct|}.\index|
|00000650| 7b 4c 49 53 54 5c 5f 52 | 43 48 41 4e 7d 0a 0a 54 |{LIST\_R|CHAN}..T|
|00000660| 68 65 20 75 73 65 20 6f | 66 20 74 68 65 20 73 74 |he use o|f the st|
|00000670| 72 75 63 74 75 72 65 20 | 6d 65 6d 62 65 72 73 20 |ructure |members |
|00000680| 61 72 65 3a 0a 5c 62 65 | 67 69 6e 7b 64 65 73 63 |are:.\be|gin{desc|
|00000690| 72 69 62 65 7d 0a 5c 69 | 74 65 6d 5b 5c 76 65 72 |ribe}.\i|tem[\ver|
|000006a0| 62 7c 6c 69 5c 5f 6d 74 | 61 7c 3a 5d 20 54 68 65 |b|li\_mt|a|:] The|
|000006b0| 20 4d 54 41 20 6e 61 6d | 65 20 61 73 20 61 20 63 | MTA nam|e as a c|
|000006c0| 68 61 72 61 63 74 65 72 | 20 73 74 72 69 6e 67 2e |haracter| string.|
|000006d0| 0a 5c 69 74 65 6d 5b 5c | 76 65 72 62 7c 6c 69 5c |.\item[\|verb|li\|
|000006e0| 5f 63 68 61 6e 7c 3a 5d | 20 54 68 65 20 61 73 73 |_chan|:]| The ass|
|000006f0| 6f 63 69 61 74 65 64 20 | 63 68 61 6e 6e 65 6c 20 |ociated |channel |
|00000700| 73 74 72 75 63 74 75 72 | 65 2e 0a 5c 69 74 65 6d |structur|e..\item|
|00000710| 5b 5c 76 65 72 62 7c 6c | 69 5c 5f 61 75 74 68 7c |[\verb|l|i\_auth||
|00000720| 3a 5d 20 41 75 74 68 6f | 72 69 73 61 74 69 6f 6e |:] Autho|risation|
|00000730| 20 70 61 72 61 6d 65 74 | 65 72 73 2e 20 54 68 69 | paramet|ers. Thi|
|00000740| 73 20 73 68 6f 75 6c 64 | 20 6e 6f 74 0a 6e 6f 72 |s should| not.nor|
|00000750| 6d 61 6c 6c 79 20 62 65 | 20 66 69 6c 6c 65 64 20 |mally be| filled |
|00000760| 69 6e 2e 0a 5c 69 74 65 | 6d 5b 5c 76 65 72 62 7c |in..\ite|m[\verb||
|00000770| 6c 69 5c 5f 64 69 72 7c | 3a 5d 20 41 20 64 69 72 |li\_dir||:] A dir|
|00000780| 65 63 74 6f 72 79 20 72 | 65 66 65 72 65 6e 63 65 |ectory r|eference|
|00000790| 2e 20 54 68 69 73 20 73 | 68 6f 75 6c 64 20 6e 6f |. This s|hould no|
|000007a0| 74 20 6e 6f 72 6d 61 6c | 6c 79 0a 62 65 20 75 73 |t normal|ly.be us|
|000007b0| 65 64 2e 0a 5c 69 74 65 | 6d 5b 5c 76 65 72 62 7c |ed..\ite|m[\verb||
|000007c0| 6c 69 5c 5f 6e 65 78 74 | 7c 3a 5d 20 54 68 65 20 |li\_next||:] The |
|000007d0| 6e 65 78 74 20 65 6c 65 | 6d 65 6e 74 20 69 6e 20 |next ele|ment in |
|000007e0| 74 68 65 20 6c 69 73 74 | 2e 0a 5c 65 6e 64 7b 64 |the list|..\end{d|
|000007f0| 65 73 63 72 69 62 65 7d | 0a 0a 54 68 65 72 65 20 |escribe}|..There |
|00000800| 61 72 65 20 73 65 76 65 | 72 61 6c 20 72 6f 75 74 |are seve|ral rout|
|00000810| 69 6e 65 73 20 74 6f 20 | 6d 61 6e 69 70 75 6c 61 |ines to |manipula|
|00000820| 74 65 20 73 75 63 68 20 | 73 74 72 75 63 74 75 72 |te such |structur|
|00000830| 65 73 2e 0a 0a 0a 41 20 | 6e 65 77 20 6c 69 73 74 |es....A |new list|
|00000840| 20 65 6c 65 6d 65 6e 74 | 20 63 61 6e 20 62 65 20 | element| can be |
|00000850| 63 72 65 61 74 65 64 20 | 62 79 20 75 73 69 6e 67 |created |by using|
|00000860| 20 74 68 65 20 72 6f 75 | 74 69 6e 65 0a 5c 76 65 | the rou|tine.\ve|
|00000870| 72 62 7c 6c 69 73 74 5f | 72 63 68 61 6e 5f 6e 65 |rb|list_|rchan_ne|
|00000880| 77 7c 2e 20 54 68 69 73 | 20 69 73 20 64 65 66 69 |w|. This| is defi|
|00000890| 6e 65 64 20 61 73 3a 0a | 5c 62 65 67 69 6e 7b 71 |ned as:.|\begin{q|
|000008a0| 75 6f 74 65 7d 5c 69 6e | 64 65 78 7b 6c 69 73 74 |uote}\in|dex{list|
|000008b0| 5c 5f 72 63 68 61 6e 5c | 5f 6e 65 77 7d 5c 62 65 |\_rchan\|_new}\be|
|000008c0| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0a 4c 49 |gin{verb|atim}.LI|
|000008d0| 53 54 5f 52 43 48 41 4e | 20 2a 6c 69 73 74 5f 72 |ST_RCHAN| *list_r|
|000008e0| 63 68 61 6e 5f 6e 65 77 | 20 28 6d 74 61 2c 20 63 |chan_new| (mta, c|
|000008f0| 68 61 6e 29 0a 63 68 61 | 72 20 2a 6d 74 61 3b 0a |han).cha|r *mta;.|
|00000900| 63 68 61 72 20 2a 63 68 | 61 6e 3b 0a 5c 65 6e 64 |char *ch|an;.\end|
|00000910| 7b 76 65 72 62 61 74 69 | 6d 7d 5c 65 6e 64 7b 71 |{verbati|m}\end{q|
|00000920| 75 6f 74 65 7d 0a 54 68 | 65 20 70 61 72 61 6d 65 |uote}.Th|e parame|
|00000930| 74 65 72 73 20 74 6f 20 | 74 68 69 73 20 63 61 6c |ters to |this cal|
|00000940| 6c 20 61 72 65 3a 0a 5c | 62 65 67 69 6e 7b 64 65 |l are:.\|begin{de|
|00000950| 73 63 72 69 62 65 7d 0a | 5c 69 74 65 6d 5b 5c 76 |scribe}.|\item[\v|
|00000960| 65 72 62 7c 6d 74 61 7c | 3a 5d 20 54 68 65 20 6e |erb|mta||:] The n|
|00000970| 61 6d 65 20 6f 66 20 74 | 68 65 20 4d 54 41 2e 20 |ame of t|he MTA. |
|00000980| 54 68 69 73 20 70 61 72 | 61 6d 65 74 65 72 20 69 |This par|ameter i|
|00000990| 73 20 63 6f 70 69 65 64 | 20 69 6e 74 6f 70 0a 68 |s copied| intop.h|
|000009a0| 65 61 70 20 73 74 6f 72 | 61 67 65 2e 0a 5c 69 74 |eap stor|age..\it|
|000009b0| 65 6d 5b 5c 76 65 72 62 | 7c 63 68 61 6e 7c 3a 5d |em[\verb||chan|:]|
|000009c0| 20 54 68 65 20 6e 61 6d | 65 20 6f 66 20 61 20 63 | The nam|e of a c|
|000009d0| 68 61 6e 6e 65 6c 2e 20 | 54 68 69 73 20 69 73 20 |hannel. |This is |
|000009e0| 63 6f 6e 76 65 72 74 65 | 64 20 74 6f 20 61 0a 63 |converte|d to a.c|
|000009f0| 68 61 6e 6e 65 6c 20 73 | 74 72 75 63 74 75 72 65 |hannel s|tructure|
|00000a00| 20 69 6e 74 65 72 6e 61 | 6c 6c 79 2e 0a 5c 65 6e | interna|lly..\en|
|00000a10| 64 7b 64 65 73 63 72 69 | 62 65 7d 0a 0a 41 20 6e |d{descri|be}..A n|
|00000a20| 65 77 20 73 74 72 75 63 | 74 75 72 65 20 63 61 6e |ew struc|ture can|
|00000a30| 20 62 65 20 61 64 64 65 | 64 20 6f 6e 74 6f 20 74 | be adde|d onto t|
|00000a40| 68 65 20 65 6e 64 20 6f | 66 20 61 20 6c 69 73 74 |he end o|f a list|
|00000a50| 2c 20 6f 72 20 69 66 20 | 74 68 65 20 6c 69 73 74 |, or if |the list|
|00000a60| 20 69 73 0a 65 6d 70 74 | 79 20 63 61 6e 20 62 65 | is.empt|y can be|
|00000a70| 20 73 65 74 20 61 73 20 | 74 68 65 20 66 69 72 73 | set as |the firs|
|00000a80| 74 20 65 6c 65 6d 65 6e | 74 20 62 79 20 61 20 63 |t elemen|t by a c|
|00000a90| 61 6c 6c 20 74 6f 0a 5c | 76 65 72 62 7c 6c 69 73 |all to.\|verb|lis|
|00000aa0| 74 5f 72 63 68 61 6e 5f | 61 64 64 7c 2e 20 54 68 |t_rchan_|add|. Th|
|00000ab0| 69 73 20 69 73 20 64 65 | 66 69 6e 65 64 20 61 73 |is is de|fined as|
|00000ac0| 3a 0a 5c 62 65 67 69 6e | 7b 71 75 6f 74 65 7d 5c |:.\begin|{quote}\|
|00000ad0| 69 6e 64 65 78 7b 6c 69 | 73 74 5c 5f 72 63 68 61 |index{li|st\_rcha|
|00000ae0| 6e 5c 5f 61 64 64 7d 5c | 62 65 67 69 6e 7b 76 65 |n\_add}\|begin{ve|
|00000af0| 72 62 61 74 69 6d 7d 0a | 76 6f 69 64 20 6c 69 73 |rbatim}.|void lis|
|00000b00| 74 5f 72 63 68 61 6e 5f | 61 64 64 20 28 62 61 73 |t_rchan_|add (bas|
|00000b10| 65 2c 20 6e 65 77 29 0a | 4c 49 53 54 5f 52 43 48 |e, new).|LIST_RCH|
|00000b20| 41 4e 20 2a 2a 62 61 73 | 65 3b 0a 4c 49 53 54 5f |AN **bas|e;.LIST_|
|00000b30| 52 43 48 41 4e 20 2a 6e | 65 77 3b 0a 5c 65 6e 64 |RCHAN *n|ew;.\end|
|00000b40| 7b 76 65 72 62 61 74 69 | 6d 7d 5c 65 6e 64 7b 71 |{verbati|m}\end{q|
|00000b50| 75 6f 74 65 7d 0a 0a 54 | 68 65 20 6c 69 6e 6b 65 |uote}..T|he linke|
|00000b60| 64 20 6c 69 73 74 20 73 | 74 72 75 63 74 75 72 65 |d list s|tructure|
|00000b70| 20 63 61 6e 20 62 65 20 | 66 72 65 65 64 20 62 79 | can be |freed by|
|00000b80| 20 63 61 6c 6c 69 6e 67 | 0a 5c 76 65 72 62 7c 6c | calling|.\verb|l|
|00000b90| 69 73 74 5f 72 63 68 61 | 6e 5f 66 72 65 65 7c 2c |ist_rcha|n_free|,|
|00000ba0| 20 77 68 69 63 68 20 69 | 73 20 64 65 66 69 6e 65 | which i|s define|
|00000bb0| 64 20 61 73 3a 0a 5c 62 | 65 67 69 6e 7b 71 75 6f |d as:.\b|egin{quo|
|00000bc0| 74 65 7d 5c 69 6e 64 65 | 78 7b 6c 69 73 74 5c 5f |te}\inde|x{list\_|
|00000bd0| 72 63 68 61 6e 5c 5f 66 | 72 65 65 7d 5c 62 65 67 |rchan\_f|ree}\beg|
|00000be0| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0a 76 6f 69 |in{verba|tim}.voi|
|00000bf0| 64 20 6c 69 73 74 5f 72 | 63 68 61 6e 5f 66 72 65 |d list_r|chan_fre|
|00000c00| 65 20 28 6c 69 73 74 29 | 0a 4c 49 53 54 5f 52 43 |e (list)|.LIST_RC|
|00000c10| 48 41 4e 20 2a 6c 69 73 | 74 3b 0a 5c 65 6e 64 7b |HAN *lis|t;.\end{|
|00000c20| 76 65 72 62 61 74 69 6d | 7d 5c 65 6e 64 7b 71 75 |verbatim|}\end{qu|
|00000c30| 6f 74 65 7d 0a 0a 54 77 | 6f 20 6f 74 68 65 72 20 |ote}..Tw|o other |
|00000c40| 75 73 65 66 75 6c 20 72 | 6f 75 74 69 6e 65 73 20 |useful r|outines |
|00000c50| 61 72 65 20 74 68 6f 73 | 65 20 74 6f 20 63 6f 6e |are thos|e to con|
|00000c60| 76 65 72 74 20 61 20 73 | 74 72 69 6e 67 20 69 6e |vert a s|tring in|
|00000c70| 74 6f 20 61 20 63 68 61 | 6e 6e 65 6c 0a 73 74 72 |to a cha|nnel.str|
|00000c80| 75 63 74 75 72 65 2e 20 | 54 68 65 20 66 69 72 73 |ucture. |The firs|
|00000c90| 74 20 6f 6e 65 20 69 73 | 20 61 20 73 69 6d 70 6c |t one is| a simpl|
|00000ca0| 65 20 73 74 72 69 6e 67 | 20 74 6f 20 73 74 72 75 |e string| to stru|
|00000cb0| 63 74 75 72 65 20 72 6f | 75 74 69 6e 65 3a 0a 5c |cture ro|utine:.\|
|00000cc0| 62 65 67 69 6e 7b 71 75 | 6f 74 65 7d 5c 69 6e 64 |begin{qu|ote}\ind|
|00000cd0| 65 78 7b 63 68 5c 5f 6e | 6d 32 73 74 72 75 63 74 |ex{ch\_n|m2struct|
|00000ce0| 7d 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |}\begin{|verbatim|
|00000cf0| 7d 0a 43 48 41 4e 20 2a | 63 68 5f 6e 6d 32 73 74 |}.CHAN *|ch_nm2st|
|00000d00| 72 75 63 74 20 28 6e 61 | 6d 65 29 0a 63 68 61 72 |ruct (na|me).char|
|00000d10| 20 2a 6e 61 6d 65 3b 0a | 5c 65 6e 64 7b 76 65 72 | *name;.|\end{ver|
|00000d20| 62 61 74 69 6d 7d 5c 65 | 6e 64 7b 71 75 6f 74 65 |batim}\e|nd{quote|
|00000d30| 7d 0a 54 68 69 73 20 63 | 6f 6e 76 65 72 74 73 20 |}.This c|onverts |
|00000d40| 66 72 6f 6d 20 74 68 65 | 20 67 69 76 65 6e 20 5c |from the| given \|
|00000d50| 76 65 72 62 7c 6e 61 6d | 65 7c 20 69 6e 74 6f 20 |verb|nam|e| into |
|00000d60| 61 20 63 68 61 6e 6e 65 | 6c 20 73 74 72 75 63 74 |a channe|l struct|
|00000d70| 75 72 65 2c 20 6f 72 0a | 72 65 74 75 72 6e 73 20 |ure, or.|returns |
|00000d80| 5c 76 65 72 62 7c 4e 55 | 4c 4c 43 48 41 4e 7c 20 |\verb|NU|LLCHAN| |
|00000d90| 69 66 20 74 68 65 72 65 | 20 69 73 20 6e 6f 20 6d |if there| is no m|
|00000da0| 61 74 63 68 2e 0a 0a 46 | 6f 72 20 69 6e 62 6f 75 |atch...F|or inbou|
|00000db0| 6e 64 20 63 68 61 6e 6e | 65 6c 73 20 77 68 65 6e |nd chann|els when|
|00000dc0| 20 66 69 6c 6c 69 6e 67 | 20 69 6e 20 74 68 65 20 | filling| in the |
|00000dd0| 71 75 65 75 65 20 73 74 | 72 75 63 74 75 72 65 20 |queue st|ructure |
|00000de0| 77 69 74 68 20 69 6e 62 | 6f 75 6e 64 0a 70 61 72 |with inb|ound.par|
|00000df0| 61 6d 65 74 65 72 73 20 | 69 74 20 69 73 20 6e 65 |ameters |it is ne|
|00000e00| 63 65 73 73 61 72 79 20 | 66 69 72 73 74 20 74 6f |cessary |first to|
|00000e10| 20 61 6c 6c 6f 63 61 74 | 65 20 61 20 63 68 61 6e | allocat|e a chan|
|00000e20| 6e 65 6c 20 6c 69 73 74 | 20 77 69 74 68 20 6f 6e |nel list| with on|
|00000e30| 65 0a 6f 66 20 74 68 65 | 20 61 62 6f 76 65 20 66 |e.of the| above f|
|00000e40| 75 6e 63 74 69 6f 6e 73 | 2c 20 62 75 74 20 6e 6f |unctions|, but no|
|00000e50| 74 20 74 6f 20 66 69 6c | 6c 20 69 6e 20 74 68 65 |t to fil|l in the|
|00000e60| 20 63 68 61 6e 6e 65 6c | 20 70 61 72 74 20 6f 66 | channel| part of|
|00000e70| 20 69 74 2e 0a 54 68 69 | 73 20 73 68 6f 75 6c 64 | it..Thi|s should|
|00000e80| 20 62 65 20 66 69 6c 6c | 65 64 20 69 6e 20 77 69 | be fill|ed in wi|
|00000e90| 74 68 20 74 68 65 20 72 | 6f 75 74 69 6e 65 3a 0a |th the r|outine:.|
|00000ea0| 5c 62 65 67 69 6e 7b 71 | 75 6f 74 65 7d 5c 69 6e |\begin{q|uote}\in|
|00000eb0| 64 65 78 7b 63 68 5c 5f | 6d 74 61 32 73 74 72 75 |dex{ch\_|mta2stru|
|00000ec0| 63 74 7d 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |ct}\begi|n{verbat|
|00000ed0| 69 6d 7d 0a 43 48 41 4e | 20 2a 63 68 5f 6d 74 61 |im}.CHAN| *ch_mta|
|00000ee0| 32 73 74 72 75 63 74 20 | 28 6e 61 6d 65 2c 20 6d |2struct |(name, m|
|00000ef0| 74 61 29 0a 63 68 61 72 | 20 2a 6e 61 6d 65 2c 20 |ta).char| *name, |
|00000f00| 2a 6d 74 61 3b 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |*mta;.\e|nd{verba|
|00000f10| 74 69 6d 7d 5c 65 6e 64 | 7b 71 75 6f 74 65 7d 0a |tim}\end|{quote}.|
|00000f20| 54 68 69 73 20 72 6f 75 | 74 69 6e 65 20 72 65 74 |This rou|tine ret|
|00000f30| 75 72 6e 73 20 61 20 63 | 68 61 6e 6e 65 6c 20 73 |urns a c|hannel s|
|00000f40| 74 72 75 63 74 75 72 65 | 20 62 61 73 65 64 20 6f |tructure| based o|
|00000f50| 6e 20 61 20 6e 61 6d 65 | 20 61 6e 64 20 61 6e 20 |n a name| and an |
|00000f60| 4d 54 41 2e 0a 54 68 69 | 73 20 61 6c 6c 6f 77 73 |MTA..Thi|s allows|
|00000f70| 20 74 68 65 20 70 61 72 | 74 69 63 75 6c 61 72 20 | the par|ticular |
|00000f80| 63 68 61 6e 6e 65 6c 20 | 74 6f 20 62 65 20 73 65 |channel |to be se|
|00000f90| 6c 65 63 74 65 64 20 64 | 65 70 65 6e 64 61 6e 74 |lected d|ependant|
|00000fa0| 20 75 70 6f 6e 20 74 68 | 65 0a 4d 54 41 20 74 68 | upon th|e.MTA th|
|00000fb0| 65 20 6d 65 73 73 61 67 | 65 20 69 73 20 72 65 63 |e messag|e is rec|
|00000fc0| 65 69 76 65 64 20 66 72 | 6f 6d 2e 20 54 68 69 73 |eived fr|om. This|
|00000fd0| 20 61 6c 6c 6f 77 73 20 | 74 68 65 20 63 68 61 6e | allows |the chan|
|00000fe0| 6e 65 6c 20 70 61 69 72 | 69 6e 67 20 74 6f 0a 74 |nel pair|ing to.t|
|00000ff0| 61 6b 65 20 70 6c 61 63 | 65 2e 0a 0a 5c 73 75 62 |ake plac|e...\sub|
|00001000| 73 75 62 73 65 63 74 69 | 6f 6e 7b 45 6e 63 6f 64 |subsecti|on{Encod|
|00001010| 65 64 20 49 6e 66 6f 72 | 6d 61 74 69 6f 6e 20 54 |ed Infor|mation T|
|00001020| 79 70 65 73 7d 0a 45 6e | 63 6f 64 65 64 20 69 6e |ypes}.En|coded in|
|00001030| 66 6f 72 6d 61 74 69 6f | 6e 20 74 79 70 65 73 20 |formatio|n types |
|00001040| 61 72 65 20 75 73 65 64 | 20 69 6e 20 73 65 76 65 |are used| in seve|
|00001050| 72 61 6c 20 70 6c 61 63 | 65 73 20 69 6e 20 50 50 |ral plac|es in PP|
|00001060| 2e 20 54 68 65 79 20 61 | 72 65 0a 6b 65 70 74 20 |. They a|re.kept |
|00001070| 69 6e 74 65 72 6e 61 6c | 6c 79 20 61 73 20 61 20 |internal|ly as a |
|00001080| 6c 69 6e 6b 65 64 20 6c | 69 73 74 20 6f 66 20 73 |linked l|ist of s|
|00001090| 74 72 69 6e 67 73 20 77 | 68 69 63 68 20 63 6f 6e |trings w|hich con|
|000010a0| 74 61 69 6e 20 65 69 74 | 68 65 72 20 74 68 65 0a |tain eit|her the.|
|000010b0| 6e 61 6d 65 20 6f 66 20 | 74 68 65 20 69 6e 66 6f |name of |the info|
|000010c0| 72 6d 61 74 69 6f 6e 20 | 74 79 70 65 2c 20 6f 72 |rmation |type, or|
|000010d0| 20 61 20 73 74 72 69 6e | 67 20 72 65 70 72 65 73 | a strin|g repres|
|000010e0| 65 6e 74 61 74 69 6f 6e | 20 6f 66 20 61 6e 20 6f |entation| of an o|
|000010f0| 62 6a 65 63 74 0a 69 64 | 65 6e 74 69 66 69 65 72 |bject.id|entifier|
|00001100| 2e 20 54 68 65 20 73 74 | 72 75 63 74 75 72 65 20 |. The st|ructure |
|00001110| 69 73 20 73 68 6f 77 6e | 20 69 6e 20 46 69 67 75 |is shown| in Figu|
|00001120| 72 65 7e 5c 72 65 66 7b | 65 69 74 3a 73 74 72 75 |re~\ref{|eit:stru|
|00001130| 63 74 7d 2e 0a 0a 5c 74 | 61 67 72 69 6e 64 5b 68 |ct}...\t|agrind[h|
|00001140| 62 74 70 5d 7b 65 69 74 | 7d 7b 45 6e 63 6f 64 65 |btp]{eit|}{Encode|
|00001150| 64 20 49 6e 66 6f 72 6d | 61 74 69 6f 6e 20 54 79 |d Inform|ation Ty|
|00001160| 70 65 20 53 74 72 75 63 | 74 75 72 65 7d 7b 65 69 |pe Struc|ture}{ei|
|00001170| 74 3a 73 74 72 75 63 74 | 7d 0a 0a 54 68 65 72 65 |t:struct|}..There|
|00001180| 20 61 72 65 20 73 6f 6d | 65 20 73 75 70 70 6f 72 | are som|e suppor|
|00001190| 74 20 72 6f 75 74 69 6e | 65 73 20 74 6f 20 68 65 |t routin|es to he|
|000011a0| 6c 70 20 63 6f 6e 73 74 | 72 75 63 74 20 74 68 65 |lp const|ruct the|
|000011b0| 73 65 20 6c 69 73 74 73 | 2e 0a 41 20 6e 65 77 20 |se lists|..A new |
|000011c0| 73 74 72 75 63 74 75 72 | 65 20 63 61 6e 20 62 65 |structur|e can be|
|000011d0| 20 61 6c 6c 6f 63 61 74 | 65 64 20 77 69 74 68 20 | allocat|ed with |
|000011e0| 61 20 76 61 6c 75 65 20 | 73 74 6f 72 65 64 20 69 |a value |stored i|
|000011f0| 6e 20 68 65 6c 70 20 73 | 70 61 63 65 20 62 79 0a |n help s|pace by.|
|00001200| 75 73 69 6e 67 20 74 68 | 65 20 66 75 6e 63 74 69 |using th|e functi|
|00001210| 6f 6e 20 5c 76 65 72 62 | 7c 6c 69 73 74 5f 62 70 |on \verb||list_bp|
|00001220| 74 5f 6e 65 77 7c 2e 20 | 54 68 69 73 20 69 73 20 |t_new|. |This is |
|00001230| 64 65 66 69 6e 65 64 20 | 61 73 3a 0a 5c 62 65 67 |defined |as:.\beg|
|00001240| 69 6e 7b 71 75 6f 74 65 | 7d 5c 69 6e 64 65 78 7b |in{quote|}\index{|
|00001250| 6c 69 73 74 5c 5f 62 70 | 74 5c 5f 6e 65 77 7d 5c |list\_bp|t\_new}\|
|00001260| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0a |begin{ve|rbatim}.|
|00001270| 4c 49 53 54 5f 42 50 54 | 20 2a 6c 69 73 74 5f 62 |LIST_BPT| *list_b|
|00001280| 70 74 5f 6e 65 77 20 28 | 76 61 6c 75 65 29 0a 63 |pt_new (|value).c|
|00001290| 68 61 72 20 2a 76 61 6c | 75 65 3b 0a 5c 65 6e 64 |har *val|ue;.\end|
|000012a0| 7b 76 65 72 62 61 74 69 | 6d 7d 5c 65 6e 64 7b 71 |{verbati|m}\end{q|
|000012b0| 75 6f 74 65 7d 0a 0a 41 | 20 6c 69 6e 6b 65 64 20 |uote}..A| linked |
|000012c0| 6c 69 73 74 20 73 74 72 | 75 63 74 75 72 65 20 63 |list str|ucture c|
|000012d0| 61 6e 20 62 65 20 64 75 | 70 6c 69 63 61 74 65 64 |an be du|plicated|
|000012e0| 20 62 79 20 75 73 69 6e | 67 0a 5c 76 65 72 62 7c | by usin|g.\verb||
|000012f0| 6c 69 73 74 5f 62 70 74 | 5f 64 75 70 7c 2e 20 54 |list_bpt|_dup|. T|
|00001300| 68 69 73 20 72 65 74 75 | 72 6e 73 20 61 20 73 65 |his retu|rns a se|
|00001310| 70 61 72 61 74 65 20 64 | 75 70 6c 69 63 61 74 65 |parate d|uplicate|
|00001320| 20 6c 69 73 74 2e 20 49 | 74 20 69 73 0a 64 65 66 | list. I|t is.def|
|00001330| 69 6e 65 64 20 61 73 3a | 0a 5c 62 65 67 69 6e 7b |ined as:|.\begin{|
|00001340| 71 75 6f 74 65 7d 5c 69 | 6e 64 65 78 7b 6c 69 73 |quote}\i|ndex{lis|
|00001350| 74 5c 5f 62 70 74 5c 5f | 64 75 70 7d 5c 62 65 67 |t\_bpt\_|dup}\beg|
|00001360| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0a 4c 49 53 |in{verba|tim}.LIS|
|00001370| 54 5f 42 50 54 20 2a 6c | 69 73 74 5f 62 70 74 5f |T_BPT *l|ist_bpt_|
|00001380| 64 75 70 20 28 6c 69 73 | 74 29 0a 4c 49 53 54 5f |dup (lis|t).LIST_|
|00001390| 42 50 54 20 2a 6c 69 73 | 74 3b 0a 5c 65 6e 64 7b |BPT *lis|t;.\end{|
|000013a0| 76 65 72 62 61 74 69 6d | 7d 5c 65 6e 64 7b 71 75 |verbatim|}\end{qu|
|000013b0| 6f 74 65 7d 0a 0a 41 20 | 6e 65 77 20 65 6c 65 6d |ote}..A |new elem|
|000013c0| 65 6e 74 20 6d 61 79 20 | 62 65 20 61 64 64 65 64 |ent may |be added|
|000013d0| 20 74 6f 20 74 68 65 20 | 65 6e 64 20 6f 66 20 61 | to the |end of a|
|000013e0| 20 6c 69 73 74 2c 20 6f | 72 20 62 65 63 6f 6d 65 | list, o|r become|
|000013f0| 20 74 68 65 20 66 69 72 | 73 74 0a 6d 65 6d 62 65 | the fir|st.membe|
|00001400| 72 20 69 66 20 74 68 65 | 20 6c 69 73 74 20 69 73 |r if the| list is|
|00001410| 20 65 6d 70 74 79 2c 20 | 62 79 20 63 61 6c 6c 69 | empty, |by calli|
|00001420| 6e 67 20 5c 76 65 72 62 | 7c 6c 69 73 74 5f 62 70 |ng \verb||list_bp|
|00001430| 74 5f 61 64 64 7c 2e 20 | 54 68 69 73 20 69 73 0a |t_add|. |This is.|
|00001440| 64 65 66 69 6e 65 64 20 | 61 73 3a 0a 5c 62 65 67 |defined |as:.\beg|
|00001450| 69 6e 7b 71 75 6f 74 65 | 7d 5c 69 6e 64 65 78 7b |in{quote|}\index{|
|00001460| 6c 69 73 74 5c 5f 62 70 | 74 5c 5f 61 64 64 7d 5c |list\_bp|t\_add}\|
|00001470| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0a |begin{ve|rbatim}.|
|00001480| 76 6f 69 64 20 6c 69 73 | 74 5f 62 70 74 5f 61 64 |void lis|t_bpt_ad|
|00001490| 64 20 28 62 61 73 65 2c | 20 6e 65 77 29 0a 4c 49 |d (base,| new).LI|
|000014a0| 53 54 5f 42 50 54 20 2a | 2a 62 61 73 65 3b 0a 4c |ST_BPT *|*base;.L|
|000014b0| 49 53 54 5f 42 50 54 20 | 2a 6e 65 77 3b 0a 5c 65 |IST_BPT |*new;.\e|
|000014c0| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 5c 65 6e 64 |nd{verba|tim}\end|
|000014d0| 7b 71 75 6f 74 65 7d 0a | 0a 41 20 6c 69 73 74 20 |{quote}.|.A list |
|000014e0| 6d 61 79 20 62 65 20 73 | 65 61 72 63 68 65 64 20 |may be s|earched |
|000014f0| 66 6f 72 20 61 20 70 61 | 72 74 69 63 75 6c 61 72 |for a pa|rticular|
|00001500| 20 74 79 70 65 20 6f 66 | 20 65 6c 65 6d 65 6e 74 | type of| element|
|00001510| 20 62 79 20 75 73 69 6e | 67 0a 5c 76 65 72 62 7c | by usin|g.\verb||
|00001520| 6c 69 73 74 5f 62 70 74 | 5f 66 69 6e 64 7c 2e 20 |list_bpt|_find|. |
|00001530| 54 68 69 73 20 72 65 74 | 75 72 6e 73 20 65 69 74 |This ret|urns eit|
|00001540| 68 65 72 20 74 68 65 20 | 66 69 72 73 74 20 6d 61 |her the |first ma|
|00001550| 74 63 68 69 6e 67 20 65 | 6e 74 72 79 20 6f 72 0a |tching e|ntry or.|
|00001560| 5c 76 65 72 62 7c 4e 55 | 4c 4c 49 53 54 5f 42 50 |\verb|NU|LLIST_BP|
|00001570| 54 7c 20 69 66 20 6e 6f | 20 73 75 63 68 20 65 6c |T| if no| such el|
|00001580| 65 6d 65 6e 74 20 69 73 | 20 66 6f 75 6e 64 2e 0a |ement is| found..|
|00001590| 5c 62 65 67 69 6e 7b 71 | 75 6f 74 65 7d 5c 69 6e |\begin{q|uote}\in|
|000015a0| 64 65 78 7b 6c 69 73 74 | 5c 5f 62 70 74 5c 5f 66 |dex{list|\_bpt\_f|
|000015b0| 69 6e 64 7d 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |ind}\beg|in{verba|
|000015c0| 74 69 6d 7d 0a 4c 49 53 | 54 5f 42 50 54 20 2a 6c |tim}.LIS|T_BPT *l|
|000015d0| 69 73 74 5f 62 70 74 5f | 66 69 6e 64 20 28 6c 69 |ist_bpt_|find (li|
|000015e0| 73 74 2c 20 69 74 65 6d | 29 0a 4c 49 53 54 5f 42 |st, item|).LIST_B|
|000015f0| 50 54 20 2a 6c 69 73 74 | 3b 0a 63 68 61 72 20 2a |PT *list|;.char *|
|00001600| 69 74 65 6d 3b 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |item;.\e|nd{verba|
|00001610| 74 69 6d 7d 5c 65 6e 64 | 7b 71 75 6f 74 65 7d 0a |tim}\end|{quote}.|
|00001620| 0a 46 69 6e 61 6c 6c 79 | 2c 20 61 20 6c 69 6e 6b |.Finally|, a link|
|00001630| 65 64 20 6c 69 73 74 20 | 6d 61 79 20 62 65 20 64 |ed list |may be d|
|00001640| 65 61 6c 6c 6f 63 61 74 | 65 64 20 75 70 20 62 79 |eallocat|ed up by|
|00001650| 20 63 61 6c 6c 69 6e 67 | 20 74 68 65 20 72 6f 75 | calling| the rou|
|00001660| 74 69 6e 65 0a 5c 76 65 | 72 62 7c 6c 69 73 74 5f |tine.\ve|rb|list_|
|00001670| 62 70 74 5f 66 72 65 65 | 7c 3a 0a 5c 62 65 67 69 |bpt_free||:.\begi|
|00001680| 6e 7b 71 75 6f 74 65 7d | 5c 69 6e 64 65 78 7b 6c |n{quote}|\index{l|
|00001690| 69 73 74 5c 5f 62 70 74 | 5c 5f 66 72 65 65 7d 5c |ist\_bpt|\_free}\|
|000016a0| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0a |begin{ve|rbatim}.|
|000016b0| 76 6f 69 64 20 6c 69 73 | 74 5f 62 70 74 5f 66 72 |void lis|t_bpt_fr|
|000016c0| 65 65 20 28 6c 69 73 74 | 29 0a 4c 49 53 54 5f 42 |ee (list|).LIST_B|
|000016d0| 50 54 20 2a 6c 69 73 74 | 3b 0a 5c 65 6e 64 7b 76 |PT *list|;.\end{v|
|000016e0| 65 72 62 61 74 69 6d 7d | 5c 65 6e 64 7b 71 75 6f |erbatim}|\end{quo|
|000016f0| 74 65 7d 0a 0a 0a 5c 73 | 75 62 73 75 62 73 65 63 |te}...\s|ubsubsec|
|00001700| 74 69 6f 6e 7b 4d 61 6e | 61 67 65 6d 65 6e 74 20 |tion{Man|agement |
|00001710| 50 61 72 61 6d 65 74 65 | 72 73 7d 0a 0a 54 68 65 |Paramete|rs}..The|
|00001720| 20 6d 61 6e 61 67 65 6d | 65 6e 74 20 70 61 72 61 | managem|ent para|
|00001730| 6d 65 74 65 72 73 20 61 | 72 65 20 64 65 66 69 6e |meters a|re defin|
|00001740| 65 64 20 69 6e 20 74 68 | 65 20 66 69 6c 65 20 5c |ed in th|e file \|
|00001750| 66 69 6c 65 7b 70 72 6d | 2e 68 7d 20 61 6e 64 20 |file{prm|.h} and |
|00001760| 74 68 65 0a 73 74 72 75 | 63 74 75 72 65 20 69 73 |the.stru|cture is|
|00001770| 20 73 68 6f 77 6e 20 69 | 6e 20 46 69 67 75 72 65 | shown i|n Figure|
|00001780| 7e 5c 72 65 66 7b 70 72 | 6d 3a 73 74 72 75 63 74 |~\ref{pr|m:struct|
|00001790| 7d 2e 20 54 68 65 73 65 | 20 76 61 6c 75 65 73 20 |}. These| values |
|000017a0| 61 72 65 20 73 65 74 0a | 62 65 66 6f 72 65 20 65 |are set.|before e|
|000017b0| 61 63 68 20 6d 65 73 73 | 61 67 65 20 73 75 62 6d |ach mess|age subm|
|000017c0| 69 73 73 69 6f 6e 20 74 | 6f 20 63 68 61 6e 67 65 |ission t|o change|
|000017d0| 20 74 68 65 20 67 65 6e | 65 72 61 6c 20 70 6f 6c | the gen|eral pol|
|000017e0| 69 63 69 65 73 20 6f 66 | 0a 5c 70 67 6d 7b 73 75 |icies of|.\pgm{su|
|000017f0| 62 6d 69 74 7d 2e 0a 0a | 54 68 65 72 65 20 61 72 |bmit}...|There ar|
|00001800| 65 20 74 77 6f 20 73 75 | 70 70 6f 72 74 20 72 6f |e two su|pport ro|
|00001810| 75 74 69 6e 65 73 20 66 | 6f 72 20 6d 61 6e 69 70 |utines f|or manip|
|00001820| 75 6c 61 74 69 6e 67 20 | 74 68 69 73 20 73 74 72 |ulating |this str|
|00001830| 75 63 74 75 72 65 2e 20 | 54 68 65 0a 66 69 72 73 |ucture. |The.firs|
|00001840| 74 2c 20 5c 76 65 72 62 | 7c 70 72 6d 5f 69 6e 69 |t, \verb||prm_ini|
|00001850| 74 7c 2c 20 69 6e 69 74 | 69 61 6c 69 73 65 73 20 |t|, init|ialises |
|00001860| 74 68 65 20 73 74 72 75 | 63 74 75 72 65 20 74 6f |the stru|cture to|
|00001870| 20 69 74 73 20 64 65 66 | 61 75 6c 74 0a 73 74 61 | its def|ault.sta|
|00001880| 74 65 2e 20 54 68 65 20 | 73 65 63 6f 6e 64 2c 20 |te. The |second, |
|00001890| 5c 76 65 72 62 7c 70 72 | 6d 5f 66 72 65 65 7c 2c |\verb|pr|m_free|,|
|000018a0| 20 66 72 65 65 73 20 6f | 66 66 20 61 6c 6c 20 61 | frees o|ff all a|
|000018b0| 6c 6c 6f 63 61 74 65 64 | 20 76 61 72 69 61 62 6c |llocated| variabl|
|000018c0| 65 73 0a 77 69 74 68 69 | 6e 20 74 68 65 20 73 74 |es.withi|n the st|
|000018d0| 72 75 63 74 75 72 65 2e | 0a 5c 62 65 67 69 6e 7b |ructure.|.\begin{|
|000018e0| 71 75 6f 74 65 7d 5c 73 | 6d 61 6c 6c 5c 69 6e 64 |quote}\s|mall\ind|
|000018f0| 65 78 7b 70 72 6d 5c 5f | 69 6e 69 74 7d 5c 69 6e |ex{prm\_|init}\in|
|00001900| 64 65 78 7b 70 72 6d 5c | 5f 66 72 65 65 7d 5c 62 |dex{prm\|_free}\b|
|00001910| 65 67 69 6e 7b 76 65 72 | 62 61 74 69 6d 7d 0a 76 |egin{ver|batim}.v|
|00001920| 6f 69 64 20 70 72 6d 5f | 69 6e 69 74 20 28 70 70 |oid prm_|init (pp|
|00001930| 29 0a 73 74 72 75 63 74 | 20 70 72 6d 5f 76 61 72 |).struct| prm_var|
|00001940| 73 20 2a 70 70 3b 0a 0a | 76 6f 69 64 20 70 72 6d |s *pp;..|void prm|
|00001950| 5f 66 72 65 65 20 28 70 | 70 29 0a 73 74 72 75 63 |_free (p|p).struc|
|00001960| 74 20 70 72 6d 5f 76 61 | 72 73 20 2a 70 70 3b 0a |t prm_va|rs *pp;.|
|00001970| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 5c 65 |\end{ver|batim}\e|
|00001980| 6e 64 7b 71 75 6f 74 65 | 7d 0a 0a 0a 5c 74 61 67 |nd{quote|}...\tag|
|00001990| 72 69 6e 64 7b 70 72 6d | 73 74 72 75 63 74 7d 7b |rind{prm|struct}{|
|000019a0| 4d 61 6e 61 67 65 6d 65 | 6e 74 20 50 61 72 61 6d |Manageme|nt Param|
|000019b0| 65 74 65 72 20 53 74 72 | 75 63 74 75 72 65 7d 7b |eter Str|ucture}{|
|000019c0| 70 72 6d 3a 73 74 72 75 | 63 74 7d 0a 5c 69 6e 64 |prm:stru|ct}.\ind|
|000019d0| 65 78 7b 73 74 72 75 63 | 74 7e 70 72 6d 5c 5f 76 |ex{struc|t~prm\_v|
|000019e0| 61 72 73 7d 0a 0a 54 68 | 65 20 75 73 65 20 6f 66 |ars}..Th|e use of|
|000019f0| 20 65 61 63 68 20 6f 66 | 20 74 68 65 20 6d 65 6d | each of| the mem|
|00001a00| 62 65 72 73 20 6f 66 20 | 74 68 69 73 20 73 74 72 |bers of |this str|
|00001a10| 75 63 74 75 72 65 20 61 | 72 65 3a 0a 5c 62 65 67 |ucture a|re:.\beg|
|00001a20| 69 6e 7b 64 65 73 63 72 | 69 62 65 7d 5c 69 6e 64 |in{descr|ibe}\ind|
|00001a30| 65 78 7b 70 61 72 61 6d | 65 74 65 72 20 73 74 72 |ex{param|eter str|
|00001a40| 75 63 74 75 72 65 7d 5c | 69 6e 64 65 78 7b 70 72 |ucture}\|index{pr|
|00001a50| 6d 7d 0a 0a 5c 69 74 65 | 6d 5b 5c 76 65 72 62 7c |m}..\ite|m[\verb||
|00001a60| 70 72 6d 5c 5f 6c 6f 67 | 66 69 6c 65 7c 3a 5d 20 |prm\_log|file|:] |
|00001a70| 41 20 6c 6f 67 66 69 6c | 65 20 74 6f 20 62 65 20 |A logfil|e to be |
|00001a80| 75 73 65 64 20 66 6f 72 | 20 74 68 69 73 20 73 70 |used for| this sp|
|00001a90| 65 63 69 66 69 63 20 6d | 65 73 73 61 67 65 2e 0a |ecific m|essage..|
|00001aa0| 0a 5c 69 74 65 6d 5b 5c | 76 65 72 62 7c 70 72 6d |.\item[\|verb|prm|
|00001ab0| 5c 5f 6c 6f 67 6c 65 76 | 65 6c 7c 3a 5d 09 41 20 |\_loglev|el|:].A |
|00001ac0| 6c 6f 67 67 69 6e 67 20 | 6c 65 76 65 6c 20 74 6f |logging |level to|
|00001ad0| 20 62 65 20 75 73 65 64 | 20 66 6f 72 20 74 68 69 | be used| for thi|
|00001ae0| 73 20 6d 65 73 73 61 67 | 65 2e 0a 49 74 20 73 68 |s messag|e..It sh|
|00001af0| 6f 75 6c 64 20 62 65 20 | 6f 6e 65 20 6f 66 20 74 |ould be |one of t|
|00001b00| 68 65 20 6c 65 76 65 6c | 73 20 6f 66 20 6c 6f 67 |he level|s of log|
|00001b10| 67 69 6e 67 20 73 70 65 | 63 69 66 69 65 64 20 69 |ging spe|cified i|
|00001b20| 6e 20 5c 66 69 6c 65 7b | 6c 6c 5c 5f 6c 6f 67 2e |n \file{|ll\_log.|
|00001b30| 68 7d 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 76 65 72 62 |h}...\it|em[\verb|
|00001b40| 7c 70 72 6d 5c 5f 6f 70 | 74 73 7c 3a 5d 09 41 20 ||prm\_op|ts|:].A |
|00001b50| 73 65 74 20 6f 66 20 6f | 70 74 69 6f 6e 73 20 74 |set of o|ptions t|
|00001b60| 6f 20 63 6f 6e 74 72 6f | 6c 20 5c 70 67 6d 7b 73 |o contro|l \pgm{s|
|00001b70| 75 62 6d 69 74 7d 2e 0a | 54 68 69 73 20 73 68 6f |ubmit}..|This sho|
|00001b80| 75 6c 64 20 62 65 20 6f | 6e 65 20 6f 66 20 74 68 |uld be o|ne of th|
|00001b90| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 3a 0a 5c 5b 5c |e follow|ing:.\[\|
|00001ba0| 62 65 67 69 6e 7b 74 61 | 62 75 6c 61 72 7d 7b 7c |begin{ta|bular}{||
|00001bb0| 6c 7c 70 7b 30 2e 36 5c | 74 65 78 74 77 69 64 74 |l|p{0.6\|textwidt|
|00001bc0| 68 7d 7c 7d 0a 5c 68 6c | 69 6e 65 0a 09 5c 6d 75 |h}|}.\hl|ine..\mu|
|00001bd0| 6c 74 69 63 6f 6c 75 6d | 6e 7b 31 7d 7b 7c 63 7c |lticolum|n{1}{|c||
|00001be0| 7d 7b 5c 62 66 20 56 61 | 6c 75 65 7d 26 0a 09 09 |}{\bf Va|lue}&...|
|00001bf0| 5c 6d 75 6c 74 69 63 6f | 6c 75 6d 6e 7b 31 7d 7b |\multico|lumn{1}{|
|00001c00| 7c 63 7c 7d 7b 5c 62 66 | 20 4d 65 61 6e 69 6e 67 ||c|}{\bf| Meaning|
|00001c10| 7d 5c 5c 0a 5c 68 6c 69 | 6e 65 0a 09 5c 74 74 20 |}\\.\hli|ne..\tt |
|00001c20| 50 52 4d 5c 5f 4e 4f 4e | 45 26 09 4e 6f 20 6f 70 |PRM\_NON|E&.No op|
|00001c30| 74 69 6f 6e 73 5c 5c 0a | 09 5c 74 74 20 50 52 4d |tions\\.|.\tt PRM|
|00001c40| 5c 5f 41 43 43 45 50 54 | 41 4c 4c 26 0a 09 09 5c |\_ACCEPT|ALL&...\|
|00001c50| 70 67 6d 7b 73 75 62 6d | 69 74 7d 20 73 68 6f 75 |pgm{subm|it} shou|
|00001c60| 6c 64 20 61 63 63 65 70 | 74 20 62 61 64 20 72 65 |ld accep|t bad re|
|00001c70| 63 69 70 69 65 6e 74 20 | 61 64 64 72 65 73 73 65 |cipient |addresse|
|00001c80| 73 0a 09 09 09 61 6e 64 | 20 67 65 6e 65 72 61 74 |s....and| generat|
|00001c90| 65 20 65 72 72 6f 72 20 | 72 65 70 6f 72 74 73 20 |e error |reports |
|00001ca0| 69 74 73 65 6c 66 5c 5c | 0a 09 5c 74 74 20 50 52 |itself\\|..\tt PR|
|00001cb0| 4d 5c 5f 4e 4f 54 52 41 | 43 45 20 26 0a 09 09 5c |M\_NOTRA|CE &...\|
|00001cc0| 70 67 6d 7b 73 75 62 6d | 69 74 7d 20 73 68 6f 75 |pgm{subm|it} shou|
|00001cd0| 6c 64 20 6e 6f 74 20 67 | 65 6e 65 72 61 74 65 20 |ld not g|enerate |
|00001ce0| 52 65 63 65 69 76 65 64 | 3a 20 6f 72 20 56 69 61 |Received|: or Via|
|00001cf0| 3a 0a 09 09 09 6c 69 6e | 65 73 2e 20 5c 5c 0a 5c |:....lin|es. \\.\|
|00001d00| 68 6c 69 6e 65 0a 5c 65 | 6e 64 7b 74 61 62 75 6c |hline.\e|nd{tabul|
|00001d10| 61 72 7d 5c 5d 0a 0a 5c | 69 74 65 6d 5b 5c 76 65 |ar}\]..\|item[\ve|
|00001d20| 72 62 7c 70 72 6d 5c 5f | 70 61 73 73 77 64 7c 3a |rb|prm\_|passwd|:|
|00001d30| 5d 09 41 20 70 61 73 73 | 77 6f 72 64 20 74 6f 20 |].A pass|word to |
|00001d40| 61 75 74 68 65 6e 74 69 | 63 61 74 65 20 74 68 65 |authenti|cate the|
|00001d50| 20 6c 6f 63 61 6c 0a 75 | 73 65 72 27 73 20 73 75 | local.u|ser's su|
|00001d60| 62 6d 69 73 73 69 6f 6e | 20 28 6e 6f 74 20 75 73 |bmission| (not us|
|00001d70| 65 64 20 61 73 20 79 65 | 74 29 2e 0a 5c 65 6e 64 |ed as ye|t)..\end|
|00001d80| 7b 64 65 73 63 72 69 62 | 65 7d 0a 0a 5c 73 75 62 |{describ|e}..\sub|
|00001d90| 73 75 62 73 65 63 74 69 | 6f 6e 7b 54 68 65 20 50 |subsecti|on{The P|
|00001da0| 65 72 2d 4d 65 73 73 61 | 67 65 20 49 6e 66 6f 72 |er-Messa|ge Infor|
|00001db0| 6d 61 74 69 6f 6e 7d 0a | 0a 54 68 65 20 70 65 72 |mation}.|.The per|
|00001dc0| 2d 6d 65 73 73 61 67 65 | 20 69 6e 66 6f 72 6d 61 |-message| informa|
|00001dd0| 74 69 6f 6e 20 69 73 20 | 64 65 66 69 6e 65 64 20 |tion is |defined |
|00001de0| 69 6e 20 74 68 65 20 66 | 69 6c 65 20 5c 66 69 6c |in the f|ile \fil|
|00001df0| 65 7b 71 2e 68 7d 20 61 | 6e 64 20 74 68 65 0a 73 |e{q.h} a|nd the.s|
|00001e00| 74 72 75 63 74 75 72 65 | 20 69 73 20 73 68 6f 77 |tructure| is show|
|00001e10| 6e 20 69 6e 20 46 69 67 | 75 72 65 7e 5c 72 65 66 |n in Fig|ure~\ref|
|00001e20| 7b 71 3a 73 74 72 75 63 | 74 7d 2e 20 4f 6e 6c 79 |{q:struc|t}. Only|
|00001e30| 20 74 68 65 20 66 69 65 | 6c 64 73 20 77 68 69 63 | the fie|lds whic|
|00001e40| 68 0a 73 68 6f 75 6c 64 | 20 6f 72 20 6d 61 79 20 |h.should| or may |
|00001e50| 62 65 20 66 69 6c 6c 65 | 64 20 69 6e 20 62 79 20 |be fille|d in by |
|00001e60| 69 6e 74 65 72 66 61 63 | 65 20 70 72 6f 67 72 61 |interfac|e progra|
|00001e70| 6d 73 20 61 72 65 0a 64 | 65 73 63 72 69 62 65 64 |ms are.d|escribed|
|00001e80| 20 69 6e 20 64 65 74 61 | 69 6c 2e 20 54 68 65 20 | in deta|il. The |
|00001e90| 72 65 73 74 20 61 72 65 | 20 63 61 6c 63 75 6c 61 |rest are| calcula|
|00001ea0| 74 65 64 20 62 79 20 5c | 70 67 6d 7b 73 75 62 6d |ted by \|pgm{subm|
|00001eb0| 69 74 7d 20 69 66 0a 6e | 65 63 65 73 73 61 72 79 |it} if.n|ecessary|
|00001ec0| 2e 0a 0a 5c 74 61 67 72 | 69 6e 64 66 69 6c 65 7b |...\tagr|indfile{|
|00001ed0| 71 73 74 72 75 63 74 7d | 7b 51 75 65 75 65 20 53 |qstruct}|{Queue S|
|00001ee0| 74 72 75 63 74 75 72 65 | 7d 7b 71 3a 73 74 72 75 |tructure|}{q:stru|
|00001ef0| 63 74 7d 5c 69 6e 64 65 | 78 7b 51 5c 5f 73 74 72 |ct}\inde|x{Q\_str|
|00001f00| 75 63 74 7d 0a 0a 54 68 | 65 20 71 75 65 75 65 20 |uct}..Th|e queue |
|00001f10| 73 74 72 75 63 74 75 72 | 65 20 63 6f 6e 74 72 6f |structur|e contro|
|00001f20| 6c 73 20 6d 6f 73 74 20 | 6f 66 20 74 68 65 20 70 |ls most |of the p|
|00001f30| 65 72 20 6d 65 73 73 61 | 67 65 20 70 61 72 61 6d |er messa|ge param|
|00001f40| 65 74 65 72 73 2e 20 54 | 68 65 72 65 0a 61 72 65 |eters. T|here.are|
|00001f50| 20 61 20 6e 75 6d 62 65 | 72 20 6f 66 20 75 74 69 | a numbe|r of uti|
|00001f60| 6c 69 74 79 20 72 6f 75 | 74 69 6e 65 73 20 74 6f |lity rou|tines to|
|00001f70| 20 68 65 6c 70 20 6d 61 | 6e 69 70 75 6c 61 74 65 | help ma|nipulate|
|00001f80| 20 74 68 65 73 65 20 73 | 74 72 75 63 74 75 72 65 | these s|tructure|
|00001f90| 73 2e 0a 0a 54 68 65 20 | 72 6f 75 74 69 6e 65 20 |s...The |routine |
|00001fa0| 5c 76 65 72 62 7c 71 5f | 69 6e 69 74 7c 20 63 61 |\verb|q_|init| ca|
|00001fb0| 6e 20 62 65 20 75 73 65 | 64 20 69 6e 69 74 69 61 |n be use|d initia|
|00001fc0| 6c 69 73 65 20 61 6e 20 | 65 6d 70 74 79 20 73 74 |lise an |empty st|
|00001fd0| 72 75 63 74 75 72 65 2e | 0a 54 68 65 20 72 6f 75 |ructure.|.The rou|
|00001fe0| 74 69 6e 65 20 5c 76 65 | 72 62 7c 71 5f 66 72 65 |tine \ve|rb|q_fre|
|00001ff0| 65 7c 20 63 61 6e 20 62 | 65 20 75 73 65 64 20 74 |e| can b|e used t|
|00002000| 6f 20 66 72 65 65 20 6f | 66 66 20 61 6c 6c 6f 63 |o free o|ff alloc|
|00002010| 61 74 65 64 20 66 69 65 | 6c 64 73 0a 77 69 74 68 |ated fie|lds.with|
|00002020| 69 6e 20 74 68 65 20 73 | 74 72 75 63 74 75 72 65 |in the s|tructure|
|00002030| 2e 0a 5c 62 65 67 69 6e | 7b 71 75 6f 74 65 7d 5c |..\begin|{quote}\|
|00002040| 69 6e 64 65 78 7b 71 5c | 5f 69 6e 69 74 7d 5c 69 |index{q\|_init}\i|
|00002050| 6e 64 65 78 7b 71 5c 5f | 66 72 65 65 7d 5c 62 65 |ndex{q\_|free}\be|
|00002060| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0a 69 6e |gin{verb|atim}.in|
|00002070| 74 20 71 5f 69 6e 69 74 | 20 28 71 70 29 0a 51 5f |t q_init| (qp).Q_|
|00002080| 73 74 72 75 63 74 20 2a | 71 70 3b 0a 0a 69 6e 74 |struct *|qp;..int|
|00002090| 20 71 5f 66 72 65 65 20 | 28 71 70 29 0a 51 5f 73 | q_free |(qp).Q_s|
|000020a0| 74 72 75 63 74 20 2a 71 | 70 3b 0a 5c 65 6e 64 7b |truct *q|p;.\end{|
|000020b0| 76 65 72 62 61 74 69 6d | 7d 5c 65 6e 64 7b 71 75 |verbatim|}\end{qu|
|000020c0| 6f 74 65 7d 0a 0a 54 79 | 70 69 63 61 6c 6c 79 20 |ote}..Ty|pically |
|000020d0| 61 6e 20 69 6e 62 6f 75 | 6e 64 20 63 68 61 6e 6e |an inbou|nd chann|
|000020e0| 65 6c 20 77 69 6c 6c 20 | 6f 6e 6c 79 20 66 69 6c |el will |only fil|
|000020f0| 6c 20 69 6e 20 6f 6e 65 | 20 6f 72 20 74 77 6f 20 |l in one| or two |
|00002100| 70 61 72 61 6d 65 74 65 | 72 73 2c 0a 6d 6f 73 74 |paramete|rs,.most|
|00002110| 20 63 61 6e 20 62 65 20 | 73 61 66 65 6c 79 20 64 | can be |safely d|
|00002120| 65 66 61 75 6c 74 65 64 | 20 75 6e 6c 65 73 73 20 |efaulted| unless |
|00002130| 72 65 71 75 69 72 65 64 | 2e 20 49 74 20 69 73 20 |required|. It is |
|00002140| 69 6d 70 6f 72 74 61 6e | 74 20 74 6f 20 73 65 74 |importan|t to set|
|00002150| 0a 74 68 65 20 5c 76 65 | 72 62 7c 69 6e 62 6f 75 |.the \ve|rb|inbou|
|00002160| 6e 64 7c 20 70 61 72 61 | 6d 65 74 65 72 20 61 6e |nd| para|meter an|
|00002170| 64 20 74 6f 20 66 69 6c | 6c 20 69 6e 20 74 68 65 |d to fil|l in the|
|00002180| 20 6c 69 73 74 20 6f 66 | 20 65 6e 63 6f 64 65 64 | list of| encoded|
|00002190| 0a 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 20 74 79 70 |.informa|tion typ|
|000021a0| 65 73 20 61 6e 64 20 70 | 6f 73 73 69 62 6c 65 20 |es and p|ossible |
|000021b0| 74 68 65 20 63 6f 6e 74 | 65 6e 74 20 74 79 70 65 |the cont|ent type|
|000021c0| 2e 20 54 68 65 20 72 65 | 73 74 20 61 72 65 20 61 |. The re|st are a|
|000021d0| 6c 6c 0a 6f 70 74 69 6f | 6e 61 6c 2e 0a 0a 54 68 |ll.optio|nal...Th|
|000021e0| 65 20 65 6c 65 6d 65 6e | 74 73 20 6f 66 20 74 68 |e elemen|ts of th|
|000021f0| 65 20 71 75 65 75 65 20 | 73 74 72 75 63 74 75 72 |e queue |structur|
|00002200| 65 20 61 72 65 20 6e 6f | 77 20 64 65 73 63 72 69 |e are no|w descri|
|00002210| 62 65 64 2e 20 53 6f 6d | 65 20 65 6c 65 6d 65 6e |bed. Som|e elemen|
|00002220| 74 73 0a 68 61 76 65 20 | 61 6e 20 61 73 73 6f 63 |ts.have |an assoc|
|00002230| 69 61 74 65 64 20 66 6c | 61 67 20 77 69 74 68 20 |iated fl|ag with |
|00002240| 74 68 65 20 6e 61 6d 65 | 20 65 6e 64 69 6e 67 20 |the name| ending |
|00002250| 77 69 74 68 20 5c 76 65 | 72 62 7c 63 72 69 74 7c |with \ve|rb|crit||
|00002260| 2e 20 54 68 69 73 0a 72 | 65 66 65 72 73 20 74 6f |. This.r|efers to|
|00002270| 20 61 6e 20 65 6c 65 6d | 65 6e 74 20 69 6e 20 74 | an elem|ent in t|
|00002280| 68 65 20 73 74 72 75 63 | 74 75 72 65 20 77 69 74 |he struc|ture wit|
|00002290| 68 20 61 20 73 69 6d 69 | 6c 61 72 20 6e 61 6d 65 |h a simi|lar name|
|000022a0| 2e 20 54 68 69 73 0a 65 | 6c 65 6d 65 6e 74 20 69 |. This.e|lement i|
|000022b0| 6e 64 69 63 61 74 65 73 | 20 77 68 61 74 20 74 68 |ndicates| what th|
|000022c0| 65 20 63 72 69 74 69 63 | 61 6c 69 74 79 20 63 6f |e critic|ality co|
|000022d0| 6e 73 74 72 61 69 6e 74 | 73 20 6f 6e 20 74 68 65 |nstraint|s on the|
|000022e0| 20 65 6c 65 6d 65 6e 74 | 0a 61 72 65 2e 20 56 61 | element|.are. Va|
|000022f0| 6c 75 65 73 20 66 6f 72 | 20 74 68 65 20 73 65 74 |lues for| the set|
|00002300| 74 69 6e 67 73 20 6f 66 | 20 74 68 65 73 65 20 61 |tings of| these a|
|00002310| 72 65 20 73 68 6f 77 6e | 20 69 6e 0a 54 61 62 6c |re shown| in.Tabl|
|00002320| 65 7e 5c 72 65 66 7b 74 | 62 6c 3a 63 72 69 74 7d |e~\ref{t|bl:crit}|
|00002330| 2e 20 54 68 65 73 65 20 | 76 61 6c 75 65 73 20 6d |. These |values m|
|00002340| 61 79 20 62 65 20 6c 6f | 67 69 63 61 6c 6c 79 20 |ay be lo|gically |
|00002350| 6f 72 27 64 20 74 6f 67 | 65 74 68 65 72 20 74 6f |or'd tog|ether to|
|00002360| 0a 73 65 74 20 73 65 76 | 65 72 61 6c 20 63 72 69 |.set sev|eral cri|
|00002370| 74 69 63 61 6c 20 76 61 | 6c 75 65 73 2e 0a 0a 5c |tical va|lues...\|
|00002380| 74 61 67 74 61 62 6c 65 | 7b 63 72 69 74 7d 7b 43 |tagtable|{crit}{C|
|00002390| 72 69 74 69 63 61 6c 69 | 74 79 20 43 6f 64 65 73 |riticali|ty Codes|
|000023a0| 7d 7b 74 62 6c 3a 63 72 | 69 74 7d 0a 0a 5c 62 65 |}{tbl:cr|it}..\be|
|000023b0| 67 69 6e 7b 64 65 73 63 | 72 69 62 65 7d 5c 69 6e |gin{desc|ribe}\in|
|000023c0| 64 65 78 7b 71 75 65 75 | 65 20 73 74 72 75 63 74 |dex{queu|e struct|
|000023d0| 75 72 65 7d 5c 69 6e 64 | 65 78 7b 51 5c 5f 73 74 |ure}\ind|ex{Q\_st|
|000023e0| 72 75 63 74 7d 0a 0a 5c | 69 74 65 6d 5b 5c 76 65 |ruct}..\|item[\ve|
|000023f0| 72 62 7c 6d 73 67 74 79 | 70 65 7c 3a 5d 09 54 68 |rb|msgty|pe|:].Th|
|00002400| 65 20 74 79 70 65 20 6f | 66 20 6d 65 73 73 61 67 |e type o|f messag|
|00002410| 65 20 62 65 69 6e 67 20 | 73 75 62 6d 69 74 74 65 |e being |submitte|
|00002420| 64 2e 20 54 68 69 73 0a | 73 68 6f 75 6c 64 20 62 |d. This.|should b|
|00002430| 65 20 6f 6e 65 20 6f 66 | 20 74 68 65 20 66 6f 6c |e one of| the fol|
|00002440| 6c 6f 77 69 6e 67 3a 0a | 5c 5b 5c 62 65 67 69 6e |lowing:.|\[\begin|
|00002450| 7b 74 61 62 75 6c 61 72 | 7d 7b 7c 6c 7c 6c 7c 7d |{tabular|}{|l|l|}|
|00002460| 0a 5c 68 6c 69 6e 65 0a | 09 5c 6d 75 6c 74 69 63 |.\hline.|.\multic|
|00002470| 6f 6c 75 6d 6e 7b 31 7d | 7b 7c 63 7c 7d 7b 5c 62 |olumn{1}|{|c|}{\b|
|00002480| 66 20 56 61 6c 75 65 7d | 26 0a 09 09 5c 6d 75 6c |f Value}|&...\mul|
|00002490| 74 69 63 6f 6c 75 6d 6e | 7b 31 7d 7b 7c 63 7c 7d |ticolumn|{1}{|c|}|
|000024a0| 7b 5c 62 66 20 4d 65 61 | 6e 69 6e 67 7d 5c 5c 0a |{\bf Mea|ning}\\.|
|000024b0| 5c 68 6c 69 6e 65 0a 09 | 5c 74 74 20 4d 54 5c 5f |\hline..|\tt MT\_|
|000024c0| 55 4d 50 44 55 26 09 4e | 6f 72 6d 61 6c 20 6d 65 |UMPDU&.N|ormal me|
|000024d0| 73 73 61 67 65 5c 5c 0a | 09 5c 74 74 20 4d 54 5c |ssage\\.|.\tt MT\|
|000024e0| 5f 44 4d 50 44 55 26 09 | 41 20 64 65 6c 69 76 65 |_DMPDU&.|A delive|
|000024f0| 72 79 20 72 65 70 6f 72 | 74 5c 5c 0a 09 5c 74 74 |ry repor|t\\..\tt|
|00002500| 20 4d 54 5c 5f 50 4d 50 | 44 55 26 09 41 20 50 72 | MT\_PMP|DU&.A Pr|
|00002510| 6f 62 65 20 5c 5c 0a 5c | 68 6c 69 6e 65 0a 5c 65 |obe \\.\|hline.\e|
|00002520| 6e 64 7b 74 61 62 75 6c | 61 72 7d 5c 5d 0a 54 68 |nd{tabul|ar}\].Th|
|00002530| 65 20 5c 76 65 72 62 7c | 71 5f 69 6e 69 74 7c 20 |e \verb||q_init| |
|00002540| 72 6f 75 74 69 6e 65 20 | 64 65 66 61 75 6c 74 73 |routine |defaults|
|00002550| 20 74 68 69 73 20 76 61 | 6c 75 65 20 74 6f 20 5c | this va|lue to \|
|00002560| 76 65 72 62 7c 4d 54 5f | 55 4d 50 44 55 7c 2e 0a |verb|MT_|UMPDU|..|
|00002570| 0a 5c 69 74 65 6d 5b 5c | 76 65 72 62 7c 63 6f 6e |.\item[\|verb|con|
|00002580| 74 5c 5f 74 79 70 65 7c | 3a 5d 09 54 68 65 20 63 |t\_type||:].The c|
|00002590| 6f 6e 74 65 6e 74 20 74 | 79 70 65 20 6f 66 20 74 |ontent t|ype of t|
|000025a0| 68 65 20 6d 65 73 73 61 | 67 65 2e 20 54 68 69 73 |he messa|ge. This|
|000025b0| 0a 73 68 6f 75 6c 64 20 | 62 65 20 6f 6e 65 20 6f |.should |be one o|
|000025c0| 66 20 74 68 65 20 64 65 | 66 69 6e 65 64 20 74 79 |f the de|fined ty|
|000025d0| 70 65 73 3b 20 6e 6f 72 | 6d 61 6c 6c 79 20 6f 6e |pes; nor|mally on|
|000025e0| 65 20 6f 66 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 |e of the| followi|
|000025f0| 6e 67 3a 0a 5c 5b 5c 62 | 65 67 69 6e 7b 74 61 62 |ng:.\[\b|egin{tab|
|00002600| 75 6c 61 72 7d 7b 7c 6c | 7c 6c 7c 7d 0a 5c 68 6c |ular}{|l||l|}.\hl|
|00002610| 69 6e 65 0a 09 5c 6d 75 | 6c 74 69 63 6f 6c 75 6d |ine..\mu|lticolum|
|00002620| 6e 7b 31 7d 7b 7c 63 7c | 7d 7b 5c 62 66 20 56 61 |n{1}{|c||}{\bf Va|
|00002630| 6c 75 65 7d 26 0a 09 09 | 5c 6d 75 6c 74 69 63 6f |lue}&...|\multico|
|00002640| 6c 75 6d 6e 7b 31 7d 7b | 7c 63 7c 7d 7b 5c 62 66 |lumn{1}{||c|}{\bf|
|00002650| 20 4d 65 61 6e 69 6e 67 | 7d 5c 5c 0a 5c 68 6c 69 | Meaning|}\\.\hli|
|00002660| 6e 65 0a 09 5c 74 74 20 | 22 38 32 32 22 26 09 41 |ne..\tt |"822"&.A|
|00002670| 6e 20 52 46 43 7e 38 32 | 32 20 63 6f 6e 74 65 6e |n RFC~82|2 conten|
|00002680| 74 5c 5c 0a 09 5c 74 74 | 20 22 70 32 22 26 09 41 |t\\..\tt| "p2"&.A|
|00002690| 20 50 32 20 31 39 38 34 | 20 63 6f 6e 74 65 6e 74 | P2 1984| content|
|000026a0| 5c 5c 0a 09 5c 74 74 20 | 22 70 32 32 22 20 26 09 |\\..\tt |"p22" &.|
|000026b0| 41 20 50 32 20 31 39 38 | 38 20 63 6f 6e 74 65 6e |A P2 198|8 conten|
|000026c0| 74 20 5c 5c 0a 5c 68 6c | 69 6e 65 0a 5c 65 6e 64 |t \\.\hl|ine.\end|
|000026d0| 7b 74 61 62 75 6c 61 72 | 7d 5c 5d 0a 41 73 20 74 |{tabular|}\].As t|
|000026e0| 68 65 73 65 20 76 61 6c | 75 65 73 20 61 72 65 20 |hese val|ues are |
|000026f0| 63 6f 6d 6d 6f 6e 2c 20 | 74 68 65 79 20 61 72 65 |common, |they are|
|00002700| 20 61 76 61 69 6c 61 62 | 6c 65 20 76 69 61 20 74 | availab|le via t|
|00002710| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 0a 73 74 72 |he follo|wing.str|
|00002720| 69 6e 67 20 76 61 72 69 | 61 62 6c 65 73 2e 20 0a |ing vari|ables. .|
|00002730| 5c 62 65 67 69 6e 7b 71 | 75 6f 74 65 7d 5c 73 6d |\begin{q|uote}\sm|
|00002740| 61 6c 6c 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |all\begi|n{verbat|
|00002750| 69 6d 7d 0a 65 78 74 65 | 72 6e 20 63 68 61 72 20 |im}.exte|rn char |
|00002760| 2a 63 6f 6e 74 5f 38 32 | 32 3b 0a 65 78 74 65 72 |*cont_82|2;.exter|
|00002770| 6e 20 63 68 61 72 20 2a | 63 6f 6e 74 5f 70 32 3b |n char *|cont_p2;|
|00002780| 0a 65 78 74 65 72 6e 20 | 63 68 61 72 20 2a 63 6f |.extern |char *co|
|00002790| 6e 74 5f 70 32 32 3b 0a | 5c 65 6e 64 7b 76 65 72 |nt_p22;.|\end{ver|
|000027a0| 62 61 74 69 6d 7d 5c 65 | 6e 64 7b 71 75 6f 74 65 |batim}\e|nd{quote|
|000027b0| 7d 0a 0a 41 6e 20 65 6d | 70 74 79 20 63 6f 6e 74 |}..An em|pty cont|
|000027c0| 65 6e 74 20 69 6d 70 6c | 69 65 73 20 74 68 61 74 |ent impl|ies that|
|000027d0| 20 74 68 65 20 6d 65 73 | 73 61 67 65 20 77 69 6c | the mes|sage wil|
|000027e0| 6c 20 62 65 20 73 75 62 | 6d 69 74 74 65 64 20 69 |l be sub|mitted i|
|000027f0| 6e 0a 73 74 72 75 63 74 | 75 72 65 64 20 66 6f 72 |n.struct|ured for|
|00002800| 6d 20 28 75 73 75 61 6c | 6c 79 20 74 68 65 20 64 |m (usual|ly the d|
|00002810| 65 66 61 75 6c 74 20 66 | 6f 72 20 52 46 43 7e 38 |efault f|or RFC~8|
|00002820| 32 32 20 6d 65 73 73 61 | 67 65 73 29 2e 0a 0a 5c |22 messa|ges)...\|
|00002830| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 65 6e 63 6f 64 |item[\ve|rb|encod|
|00002840| 65 64 69 6e 66 6f 7c 3a | 5d 09 41 20 6c 69 73 74 |edinfo|:|].A list|
|00002850| 20 6f 66 20 65 6e 63 6f | 64 65 64 20 69 6e 66 6f | of enco|ded info|
|00002860| 72 6d 61 74 69 6f 6e 20 | 74 79 70 65 73 2e 0a 54 |rmation |types..T|
|00002870| 68 69 73 20 73 68 6f 75 | 6c 64 20 69 6e 63 6c 75 |his shou|ld inclu|
|00002880| 64 65 20 61 6c 6c 20 74 | 68 65 20 65 6e 63 6f 64 |de all t|he encod|
|00002890| 65 64 20 74 79 70 65 73 | 20 74 68 61 74 20 61 72 |ed types| that ar|
|000028a0| 65 20 69 6e 20 74 68 65 | 20 6d 65 73 73 61 67 65 |e in the| message|
|000028b0| 2c 20 61 6e 64 0a 73 68 | 6f 75 6c 64 20 62 65 20 |, and.sh|ould be |
|000028c0| 61 20 6d 65 6d 62 65 72 | 20 6f 66 20 74 68 65 20 |a member| of the |
|000028d0| 6c 69 73 74 20 64 65 66 | 69 6e 65 64 20 69 6e 20 |list def|ined in |
|000028e0| 74 68 65 20 62 6f 64 79 | 70 61 72 74 20 74 61 69 |the body|part tai|
|000028f0| 6c 6f 72 0a 76 61 72 69 | 61 62 6c 65 2e 0a 41 6c |lor.vari|able..Al|
|00002900| 74 68 6f 75 67 68 20 61 | 6e 79 20 65 6e 63 6f 64 |though a|ny encod|
|00002910| 65 64 20 69 6e 66 6f 72 | 6d 61 74 69 6f 6e 20 74 |ed infor|mation t|
|00002920| 79 70 65 20 70 72 65 73 | 65 6e 74 20 69 6e 20 74 |ype pres|ent in t|
|00002930| 68 65 20 62 6f 64 79 70 | 61 72 74 20 6c 69 73 74 |he bodyp|art list|
|00002940| 20 69 73 0a 61 6c 6c 6f | 77 65 64 2c 20 50 50 20 | is.allo|wed, PP |
|00002950| 6b 6e 6f 77 73 20 61 62 | 6f 75 74 20 73 6f 6d 65 |knows ab|out some|
|00002960| 20 73 70 65 63 69 61 6c | 20 63 61 73 65 73 2e 20 | special| cases. |
|00002970| 54 68 65 73 65 20 61 72 | 65 3a 0a 5c 5b 5c 62 65 |These ar|e:.\[\be|
|00002980| 67 69 6e 7b 74 61 62 75 | 6c 61 72 7d 7b 7c 6c 7c |gin{tabu|lar}{|l||
|00002990| 6c 7c 7d 0a 5c 68 6c 69 | 6e 65 0a 09 5c 6d 75 6c |l|}.\hli|ne..\mul|
|000029a0| 74 69 63 6f 6c 75 6d 6e | 7b 31 7d 7b 7c 63 7c 7d |ticolumn|{1}{|c|}|
|000029b0| 7b 5c 62 66 20 56 61 6c | 75 65 7d 26 0a 09 09 5c |{\bf Val|ue}&...\|
|000029c0| 6d 75 6c 74 69 63 6f 6c | 75 6d 6e 7b 31 7d 7b 7c |multicol|umn{1}{||
|000029d0| 63 7c 7d 7b 5c 62 66 20 | 4d 65 61 6e 69 6e 67 7d |c|}{\bf |Meaning}|
|000029e0| 5c 5c 0a 5c 68 6c 69 6e | 65 0a 09 5c 74 74 20 22 |\\.\hlin|e..\tt "|
|000029f0| 69 61 35 22 26 09 41 6e | 20 49 61 35 20 28 61 73 |ia5"&.An| Ia5 (as|
|00002a00| 63 69 69 29 20 62 6f 64 | 79 20 70 61 72 74 5c 5c |cii) bod|y part\\|
|00002a10| 0a 09 5c 74 74 20 22 68 | 64 72 2e 38 32 32 22 26 |..\tt "h|dr.822"&|
|00002a20| 09 41 6e 20 52 46 43 7e | 38 32 32 20 68 65 61 64 |.An RFC~|822 head|
|00002a30| 65 72 5c 5c 0a 09 5c 74 | 74 20 22 68 64 72 2e 70 |er\\..\t|t "hdr.p|
|00002a40| 32 22 20 26 09 41 20 50 | 32 20 31 39 38 34 20 68 |2" &.A P|2 1984 h|
|00002a50| 65 61 64 65 72 20 5c 5c | 0a 09 5c 74 74 20 22 68 |eader \\|..\tt "h|
|00002a60| 64 72 2e 70 32 32 22 20 | 26 20 41 20 50 32 20 31 |dr.p22" |& A P2 1|
|00002a70| 39 38 38 20 68 65 61 64 | 65 72 20 5c 5c 0a 09 5c |988 head|er \\..\|
|00002a80| 74 74 20 22 68 64 72 2e | 69 70 6e 22 20 26 20 41 |tt "hdr.|ipn" & A|
|00002a90| 6e 20 49 50 4e 20 68 65 | 61 64 65 72 20 5c 5c 0a |n IPN he|ader \\.|
|00002aa0| 5c 68 6c 69 6e 65 0a 5c | 65 6e 64 7b 74 61 62 75 |\hline.\|end{tabu|
|00002ab0| 6c 61 72 7d 5c 5d 0a 54 | 68 65 73 65 20 64 65 66 |lar}\].T|hese def|
|00002ac0| 69 6e 69 74 69 6f 6e 73 | 20 61 72 65 20 61 76 61 |initions| are ava|
|00002ad0| 69 6c 61 62 6c 65 20 69 | 6e 20 74 68 65 20 65 78 |ilable i|n the ex|
|00002ae0| 74 65 72 6e 61 6c 20 76 | 61 72 69 61 62 6c 65 73 |ternal v|ariables|
|00002af0| 20 61 73 20 66 6f 6c 6c | 6f 77 73 3a 0a 5c 62 65 | as foll|ows:.\be|
|00002b00| 67 69 6e 7b 71 75 6f 74 | 65 7d 5c 73 6d 61 6c 6c |gin{quot|e}\small|
|00002b10| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00002b20| 0a 65 78 74 65 72 6e 20 | 63 68 61 72 20 2a 68 64 |.extern |char *hd|
|00002b30| 72 5f 38 32 32 5f 62 70 | 3b 0a 65 78 74 65 72 6e |r_822_bp|;.extern|
|00002b40| 20 63 68 61 72 20 2a 68 | 64 72 5f 70 32 5f 62 70 | char *h|dr_p2_bp|
|00002b50| 3b 0a 65 78 74 65 72 6e | 20 63 68 61 72 20 2a 68 |;.extern| char *h|
|00002b60| 64 72 5f 70 32 32 5f 62 | 70 3b 0a 65 78 74 65 72 |dr_p22_b|p;.exter|
|00002b70| 6e 20 63 68 61 72 20 2a | 68 64 72 5f 69 70 6e 5f |n char *|hdr_ipn_|
|00002b80| 62 70 3b 0a 65 78 74 65 | 72 6e 20 63 68 61 72 20 |bp;.exte|rn char |
|00002b90| 2a 69 61 35 5f 62 70 3b | 0a 5c 65 6e 64 7b 76 65 |*ia5_bp;|.\end{ve|
|00002ba0| 72 62 61 74 69 6d 7d 5c | 65 6e 64 7b 71 75 6f 74 |rbatim}\|end{quot|
|00002bb0| 65 7d 0a 5c 65 6e 64 7b | 64 65 73 63 72 69 62 65 |e}.\end{|describe|
|00002bc0| 7d 0a 0a 54 68 65 20 66 | 6f 6c 6c 6f 77 69 6e 67 |}..The f|ollowing|
|00002bd0| 20 76 61 72 69 61 62 6c | 65 73 20 63 61 6e 20 61 | variabl|es can a|
|00002be0| 6c 6c 20 62 65 20 73 61 | 66 65 6c 79 20 64 65 66 |ll be sa|fely def|
|00002bf0| 61 75 6c 74 65 64 20 74 | 6f 20 74 68 6f 73 65 0a |aulted t|o those.|
|00002c00| 69 6e 69 74 69 61 6c 69 | 73 65 64 20 62 79 20 5c |initiali|sed by \|
|00002c10| 76 65 72 62 7c 71 5f 69 | 6e 69 74 7c 2c 20 62 75 |verb|q_i|nit|, bu|
|00002c20| 74 20 63 61 6e 20 62 65 | 20 76 61 72 69 65 64 20 |t can be| varied |
|00002c30| 61 73 20 72 65 71 75 69 | 72 65 64 2e 0a 0a 5c 62 |as requi|red...\b|
|00002c40| 65 67 69 6e 7b 64 65 73 | 63 72 69 62 65 7d 0a 0a |egin{des|cribe}..|
|00002c50| 5c 69 74 65 6d 5b 5c 76 | 65 72 62 7c 64 65 66 65 |\item[\v|erb|defe|
|00002c60| 72 74 69 6d 65 7c 3a 5d | 09 54 68 65 20 74 69 6d |rtime|:]|.The tim|
|00002c70| 65 20 74 68 65 20 6d 65 | 73 73 61 67 65 20 73 68 |e the me|ssage sh|
|00002c80| 6f 75 6c 64 20 77 61 69 | 74 20 66 6f 72 0a 62 65 |ould wai|t for.be|
|00002c90| 66 6f 72 65 20 62 65 69 | 6e 67 20 64 65 6c 69 76 |fore bei|ng deliv|
|00002ca0| 65 72 65 64 20 28 66 6f | 72 20 64 65 66 65 72 72 |ered (fo|r deferr|
|00002cb0| 65 64 20 64 65 6c 69 76 | 65 72 79 29 3a 20 6f 70 |ed deliv|ery): op|
|00002cc0| 74 69 6f 6e 61 6c 2e 0a | 0a 5c 69 74 65 6d 5b 5c |tional..|.\item[\|
|00002cd0| 76 65 72 62 7c 6c 61 74 | 65 73 74 5c 5f 74 69 6d |verb|lat|est\_tim|
|00002ce0| 65 7c 3a 5d 09 54 68 65 | 20 6c 61 74 65 73 74 20 |e|:].The| latest |
|00002cf0| 64 65 6c 69 76 65 72 79 | 20 74 69 6d 65 20 74 68 |delivery| time th|
|00002d00| 69 73 20 6d 65 73 73 61 | 67 65 0a 73 68 6f 75 6c |is messa|ge.shoul|
|00002d10| 64 20 62 65 20 64 65 6c | 69 76 65 72 65 64 20 62 |d be del|ivered b|
|00002d20| 79 2e 0a 0a 5c 69 74 65 | 6d 5b 5c 76 65 72 62 7c |y...\ite|m[\verb||
|00002d30| 6e 77 61 72 6e 73 7c 3a | 5d 09 54 68 65 20 6e 75 |nwarns|:|].The nu|
|00002d40| 6d 62 65 72 20 6f 66 20 | 77 61 72 6e 69 6e 67 20 |mber of |warning |
|00002d50| 6d 65 73 73 61 67 65 73 | 20 74 6f 20 62 65 20 73 |messages| to be s|
|00002d60| 65 6e 74 20 69 66 0a 74 | 68 65 20 6d 65 73 73 61 |ent if.t|he messa|
|00002d70| 67 65 20 69 73 20 64 65 | 6c 61 79 65 64 2e 0a 0a |ge is de|layed...|
|00002d80| 5c 69 74 65 6d 5b 5c 76 | 65 72 62 7c 77 61 72 6e |\item[\v|erb|warn|
|00002d90| 69 6e 74 65 72 76 61 6c | 7c 3a 5d 09 54 68 65 20 |interval||:].The |
|00002da0| 69 6e 74 65 72 76 61 6c | 20 6f 66 20 74 69 6d 65 |interval| of time|
|00002db0| 20 62 65 74 77 65 65 6e | 0a 73 75 63 63 65 73 73 | between|.success|
|00002dc0| 69 76 65 20 77 61 72 6e | 69 6e 67 73 2e 0a 0a 5c |ive warn|ings...\|
|00002dd0| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 72 65 74 69 6e |item[\ve|rb|retin|
|00002de0| 74 65 72 76 61 6c 7c 3a | 5d 09 54 68 65 20 74 69 |terval|:|].The ti|
|00002df0| 6d 65 20 74 6f 20 77 61 | 69 74 20 62 65 66 6f 72 |me to wa|it befor|
|00002e00| 65 20 72 65 74 75 72 6e | 69 6e 67 20 74 68 65 0a |e return|ing the.|
|00002e10| 6d 65 73 73 61 67 65 20 | 61 73 20 75 6e 64 65 6c |message |as undel|
|00002e20| 69 76 65 72 61 62 6c 65 | 2e 0a 0a 0a 5c 69 74 65 |iverable|....\ite|
|00002e30| 6d 5b 5c 76 65 72 62 7c | 70 72 69 6f 72 69 74 79 |m[\verb||priority|
|00002e40| 7c 3a 5d 09 09 54 68 65 | 20 70 72 69 6f 72 69 74 ||:]..The| priorit|
|00002e50| 79 20 61 73 73 6f 63 69 | 61 74 65 64 20 77 69 74 |y associ|ated wit|
|00002e60| 68 20 74 68 65 0a 6d 65 | 73 73 61 67 65 2e 20 54 |h the.me|ssage. T|
|00002e70| 68 69 73 20 74 61 6b 65 | 73 20 6f 6e 65 20 6f 66 |his take|s one of|
|00002e80| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 76 | the fol|lowing v|
|00002e90| 61 6c 75 65 73 3a 0a 5c | 5b 5c 62 65 67 69 6e 7b |alues:.\|[\begin{|
|00002ea0| 74 61 62 75 6c 61 72 7d | 7b 7c 6c 7c 6c 7c 7d 0a |tabular}|{|l|l|}.|
|00002eb0| 5c 68 6c 69 6e 65 0a 09 | 5c 6d 75 6c 74 69 63 6f |\hline..|\multico|
|00002ec0| 6c 75 6d 6e 7b 31 7d 7b | 7c 63 7c 7d 7b 5c 62 66 |lumn{1}{||c|}{\bf|
|00002ed0| 20 56 61 6c 75 65 7d 26 | 0a 09 09 5c 6d 75 6c 74 | Value}&|...\mult|
|00002ee0| 69 63 6f 6c 75 6d 6e 7b | 31 7d 7b 7c 63 7c 7d 7b |icolumn{|1}{|c|}{|
|00002ef0| 5c 62 66 20 4d 65 61 6e | 69 6e 67 7d 5c 5c 0a 5c |\bf Mean|ing}\\.\|
|00002f00| 68 6c 69 6e 65 0a 09 5c | 74 74 20 50 52 49 4f 5c |hline..\|tt PRIO\|
|00002f10| 5f 4e 4f 52 4d 41 4c 26 | 09 54 68 65 20 64 65 66 |_NORMAL&|.The def|
|00002f20| 61 75 6c 74 5c 5c 0a 09 | 5c 74 74 20 50 52 49 4f |ault\\..|\tt PRIO|
|00002f30| 5c 5f 4e 4f 4e 55 52 47 | 45 4e 54 26 09 41 20 6c |\_NONURG|ENT&.A l|
|00002f40| 6f 77 20 70 72 69 6f 72 | 69 74 79 20 6d 65 73 73 |ow prior|ity mess|
|00002f50| 61 67 65 5c 5c 0a 09 5c | 74 74 20 50 52 49 4f 5c |age\\..\|tt PRIO\|
|00002f60| 5f 55 52 47 45 4e 54 26 | 09 41 20 68 69 67 68 20 |_URGENT&|.A high |
|00002f70| 70 72 69 6f 72 69 74 79 | 20 6d 65 73 73 61 67 65 |priority| message|
|00002f80| 5c 5c 0a 5c 68 6c 69 6e | 65 0a 5c 65 6e 64 7b 74 |\\.\hlin|e.\end{t|
|00002f90| 61 62 75 6c 61 72 7d 5c | 5d 0a 0a 5c 69 74 65 6d |abular}\|]..\item|
|00002fa0| 5b 5c 76 65 72 62 7c 64 | 69 73 63 6c 6f 73 65 5c |[\verb|d|isclose\|
|00002fb0| 5f 72 65 63 69 70 73 7c | 3a 5d 09 41 20 74 72 75 |_recips||:].A tru|
|00002fc0| 65 2f 66 61 6c 73 65 20 | 66 6c 61 67 20 69 6e 64 |e/false |flag ind|
|00002fd0| 69 63 61 74 69 6e 67 20 | 77 68 65 74 68 65 72 0a |icating |whether.|
|00002fe0| 72 65 63 69 70 69 65 6e | 74 73 20 73 68 6f 75 6c |recipien|ts shoul|
|00002ff0| 64 20 62 65 20 64 69 73 | 63 6c 6f 73 65 64 2e 0a |d be dis|closed..|
|00003000| 0a 5c 69 74 65 6d 5b 5c | 76 65 72 62 7c 69 6d 70 |.\item[\|verb|imp|
|00003010| 6c 69 63 69 74 5c 5f 63 | 6f 6e 76 65 72 73 69 6f |licit\_c|onversio|
|00003020| 6e 7c 3a 5d 09 41 20 74 | 72 75 65 2f 66 61 6c 73 |n|:].A t|rue/fals|
|00003030| 65 20 66 6c 61 67 20 69 | 6e 64 69 63 61 74 69 6e |e flag i|ndicatin|
|00003040| 67 0a 69 66 20 69 6d 70 | 6c 69 63 69 74 20 63 6f |g.if imp|licit co|
|00003050| 6e 76 65 72 73 69 6f 6e | 20 63 61 6e 20 62 65 20 |nversion| can be |
|00003060| 70 65 72 66 6f 72 6d 65 | 64 2e 0a 0a 5c 69 74 65 |performe|d...\ite|
|00003070| 6d 5b 5c 76 65 72 62 7c | 61 6c 74 65 72 6e 61 74 |m[\verb||alternat|
|00003080| 65 5c 5f 72 65 63 69 70 | 5c 5f 61 6c 6c 6f 77 65 |e\_recip|\_allowe|
|00003090| 64 7c 3a 5d 09 41 20 74 | 72 75 65 2f 66 61 6c 73 |d|:].A t|rue/fals|
|000030a0| 65 20 66 6c 61 67 20 69 | 6e 64 69 63 61 74 69 6e |e flag i|ndicatin|
|000030b0| 67 0a 69 66 20 74 68 65 | 20 6d 65 73 73 61 67 65 |g.if the| message|
|000030c0| 20 63 61 6e 20 62 65 20 | 73 65 6e 74 20 74 6f 20 | can be |sent to |
|000030d0| 61 6e 20 61 6c 74 65 72 | 6e 61 74 65 20 72 65 63 |an alter|nate rec|
|000030e0| 69 70 69 65 6e 74 2e 0a | 0a 5c 69 74 65 6d 5b 5c |ipient..|.\item[\|
|000030f0| 76 65 72 62 7c 63 6f 6e | 74 65 6e 74 5c 5f 72 65 |verb|con|tent\_re|
|00003100| 74 75 72 6e 5c 5f 72 65 | 71 75 65 73 74 7c 3a 5d |turn\_re|quest|:]|
|00003110| 09 41 20 74 72 75 65 2f | 66 61 6c 73 65 20 66 6c |.A true/|false fl|
|00003120| 61 67 20 69 6e 64 69 63 | 61 74 69 6e 67 0a 69 66 |ag indic|ating.if|
|00003130| 20 74 68 65 20 6d 65 73 | 73 61 67 65 20 63 6f 6e | the mes|sage con|
|00003140| 74 65 6e 74 20 73 68 6f | 75 6c 64 20 62 65 20 72 |tent sho|uld be r|
|00003150| 65 74 75 72 6e 65 64 20 | 6f 6e 20 64 65 6c 69 76 |eturned |on deliv|
|00003160| 65 72 79 20 66 61 69 6c | 75 72 65 2e 0a 0a 5c 69 |ery fail|ure...\i|
|00003170| 74 65 6d 5b 5c 76 65 72 | 62 7c 72 65 63 69 70 5c |tem[\ver|b|recip\|
|00003180| 5f 72 65 61 73 73 69 67 | 6e 5c 5f 70 72 6f 68 69 |_reassig|n\_prohi|
|00003190| 62 69 74 65 64 7c 3a 5d | 20 41 20 66 6c 61 67 20 |bited|:]| A flag |
|000031a0| 69 6e 64 69 63 61 74 69 | 6e 67 20 69 66 20 74 68 |indicati|ng if th|
|000031b0| 65 0a 72 65 63 69 70 69 | 65 6e 74 20 6d 61 79 20 |e.recipi|ent may |
|000031c0| 72 65 61 73 73 69 67 6e | 20 74 68 65 20 6d 65 73 |reassign| the mes|
|000031d0| 73 61 67 65 20 74 6f 20 | 61 20 6e 65 77 20 72 65 |sage to |a new re|
|000031e0| 63 69 70 69 65 6e 74 2e | 0a 0a 5c 69 74 65 6d 5b |cipient.|..\item[|
|000031f0| 5c 76 65 72 62 7c 64 6c | 5c 5f 65 78 70 61 6e 73 |\verb|dl|\_expans|
|00003200| 69 6f 6e 5c 5f 70 72 6f | 68 69 62 69 74 65 64 7c |ion\_pro|hibited||
|00003210| 3a 5d 09 41 20 66 6c 61 | 67 20 69 6e 64 69 63 61 |:].A fla|g indica|
|00003220| 74 69 6e 67 20 69 66 20 | 74 68 65 0a 6d 65 73 73 |ting if |the.mess|
|00003230| 61 67 65 20 6d 61 79 20 | 6e 6f 74 20 62 65 20 65 |age may |not be e|
|00003240| 78 70 61 6e 64 65 64 20 | 69 6e 74 6f 20 61 20 64 |xpanded |into a d|
|00003250| 69 73 74 72 69 62 75 74 | 69 6f 6e 20 6c 69 73 74 |istribut|ion list|
|00003260| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 7c 63 |...\item|[\verb|c|
|00003270| 6f 6e 76 65 72 73 69 6f | 6e 5c 5f 77 69 74 68 5c |onversio|n\_with\|
|00003280| 5f 6c 6f 73 73 5c 5f 70 | 72 6f 68 69 62 69 74 65 |_loss\_p|rohibite|
|00003290| 64 7c 3a 5d 09 41 20 66 | 6c 61 67 20 69 6e 64 69 |d|:].A f|lag indi|
|000032a0| 63 61 74 69 6e 67 20 69 | 66 0a 63 6f 6e 76 65 72 |cating i|f.conver|
|000032b0| 73 69 6f 6e 20 69 73 20 | 61 6c 6c 6f 77 65 64 20 |sion is |allowed |
|000032c0| 65 76 65 6e 20 69 66 20 | 69 74 20 6c 6f 73 65 73 |even if |it loses|
|000032d0| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 2e 0a 0a 5c | informa|tion...\|
|000032e0| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 75 61 5c 5f 69 |item[\ve|rb|ua\_i|
|000032f0| 64 7c 3a 5d 09 54 68 65 | 20 75 73 65 72 20 61 67 |d|:].The| user ag|
|00003300| 65 6e 74 20 49 44 2e 20 | 54 68 69 73 20 69 73 20 |ent ID. |This is |
|00003310| 61 20 73 74 72 69 6e 67 | 20 74 68 61 74 0a 69 64 |a string| that.id|
|00003320| 65 6e 74 69 66 69 65 73 | 20 74 68 65 20 6d 65 73 |entifies| the mes|
|00003330| 73 61 67 65 20 74 6f 20 | 61 20 75 73 65 72 20 61 |sage to |a user a|
|00003340| 67 65 6e 74 2e 0a 0a 5c | 69 74 65 6d 5b 5c 76 65 |gent...\|item[\ve|
|00003350| 72 62 7c 70 70 5c 5f 63 | 6f 6e 74 65 6e 74 5c 5f |rb|pp\_c|ontent\_|
|00003360| 63 6f 72 72 65 6c 61 74 | 6f 72 7c 3a 5d 09 54 68 |correlat|or|:].Th|
|00003370| 65 20 69 6e 74 65 72 6e | 61 6c 20 76 65 72 73 69 |e intern|al versi|
|00003380| 6f 6e 20 6f 66 20 74 68 | 65 0a 63 6f 6e 74 65 6e |on of th|e.conten|
|00003390| 74 20 63 6f 72 72 65 6c | 61 74 6f 72 2e 0a 0a 5c |t correl|ator...\|
|000033a0| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 67 65 6e 65 72 |item[\ve|rb|gener|
|000033b0| 61 6c 5c 5f 63 6f 6e 74 | 65 6e 74 5c 5f 63 6f 72 |al\_cont|ent\_cor|
|000033c0| 72 65 6c 61 74 6f 72 7c | 3a 5d 09 54 68 65 20 63 |relator||:].The c|
|000033d0| 6f 6e 74 65 6e 74 20 63 | 6f 72 72 65 6c 61 74 6f |ontent c|orrelato|
|000033e0| 72 0a 6f 66 20 74 68 65 | 20 6d 65 73 73 61 67 65 |r.of the| message|
|000033f0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 7c 6f |...\item|[\verb|o|
|00003400| 72 69 67 69 6e 61 74 6f | 72 5c 5f 72 65 74 75 72 |riginato|r\_retur|
|00003410| 6e 5c 5f 61 64 64 72 65 | 73 73 7c 3a 5d 09 54 68 |n\_addre|ss|:].Th|
|00003420| 65 20 70 6f 73 74 61 6c | 20 72 65 74 75 72 6e 0a |e postal| return.|
|00003430| 61 64 64 72 65 73 73 20 | 6f 66 20 74 68 65 20 6f |address |of the o|
|00003440| 72 69 67 69 6e 61 74 6f | 72 2e 0a 0a 5c 69 74 65 |riginato|r...\ite|
|00003450| 6d 5b 5c 76 65 72 62 7c | 66 6f 72 77 61 72 64 69 |m[\verb||forwardi|
|00003460| 6e 67 5c 5f 72 65 71 75 | 65 73 74 7c 3a 5d 09 41 |ng\_requ|est|:].A|
|00003470| 6e 20 69 6e 64 69 63 61 | 74 69 6f 6e 20 6f 66 20 |n indica|tion of |
|00003480| 77 68 65 74 68 65 72 0a | 74 68 65 20 70 68 79 73 |whether.|the phys|
|00003490| 69 63 61 6c 20 66 6f 72 | 77 61 72 64 69 6e 67 20 |ical for|warding |
|000034a0| 61 64 64 72 65 73 73 20 | 73 68 6f 75 6c 64 20 62 |address |should b|
|000034b0| 65 20 72 65 74 75 72 6e | 65 64 20 74 6f 20 74 68 |e return|ed to th|
|000034c0| 65 20 6f 72 69 67 69 6e | 61 74 6f 72 2e 0a 0a 5c |e origin|ator...\|
|000034d0| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 6f 72 69 67 69 |item[\ve|rb|origi|
|000034e0| 6e 61 74 6f 72 5c 5f 63 | 65 72 74 69 66 69 63 61 |nator\_c|ertifica|
|000034f0| 74 65 7c 3a 5d 09 54 68 | 69 73 20 65 6c 65 6d 65 |te|:].Th|is eleme|
|00003500| 6e 74 20 63 6f 6e 76 65 | 79 73 20 74 68 65 0a 63 |nt conve|ys the.c|
|00003510| 65 72 74 69 66 69 63 61 | 74 65 20 6f 66 20 74 68 |ertifica|te of th|
|00003520| 65 20 6f 72 69 67 69 6e | 61 74 6f 72 20 77 68 65 |e origin|ator whe|
|00003530| 6e 20 73 65 63 75 75 72 | 65 20 6d 65 73 73 61 67 |n secuur|e messag|
|00003540| 69 6e 67 20 69 73 20 62 | 65 69 6e 67 20 75 73 65 |ing is b|eing use|
|00003550| 64 2e 0a 0a 5c 69 74 65 | 6d 5b 5c 76 65 72 62 7c |d...\ite|m[\verb||
|00003560| 61 6c 67 6f 72 69 74 68 | 6d 5c 5f 69 64 65 6e 74 |algorith|m\_ident|
|00003570| 69 66 69 65 72 7c 3a 5d | 09 41 6e 20 69 6e 64 69 |ifier|:]|.An indi|
|00003580| 63 61 74 69 6f 6e 20 6f | 66 20 74 68 65 0a 65 6e |cation o|f the.en|
|00003590| 63 72 79 70 74 69 6f 6e | 20 61 6c 67 6f 72 69 74 |cryption| algorit|
|000035a0| 68 6d 20 75 73 65 64 20 | 66 6f 72 20 6d 65 73 73 |hm used |for mess|
|000035b0| 61 67 65 20 65 6e 63 72 | 79 70 74 69 6f 6e 2e 0a |age encr|yption..|
|000035c0| 0a 5c 69 74 65 6d 5b 5c | 76 65 72 62 7c 6d 65 73 |.\item[\|verb|mes|
|000035d0| 73 61 67 65 5c 5f 6f 72 | 69 67 69 6e 5c 5f 61 75 |sage\_or|igin\_au|
|000035e0| 74 68 5c 5f 63 68 65 63 | 6b 7c 3a 5d 09 54 68 69 |th\_chec|k|:].Thi|
|000035f0| 73 20 65 6c 65 6d 65 6e | 74 20 61 6c 6c 6f 77 73 |s elemen|t allows|
|00003600| 0a 4d 54 41 73 20 61 6e | 64 20 72 65 63 69 70 69 |.MTAs an|d recipi|
|00003610| 65 6e 74 73 20 74 6f 20 | 5c 6c 69 6e 65 62 72 65 |ents to |\linebre|
|00003620| 61 6b 5b 33 5d 20 61 75 | 74 68 65 6e 74 69 63 61 |ak[3] au|thentica|
|00003630| 74 65 20 74 68 65 20 6d | 65 73 73 61 67 65 20 6f |te the m|essage o|
|00003640| 72 69 67 69 6e 2e 0a 0a | 5c 69 74 65 6d 5b 5c 76 |rigin...|\item[\v|
|00003650| 65 72 62 7c 73 65 63 75 | 72 69 74 79 5c 5f 6c 61 |erb|secu|rity\_la|
|00003660| 62 65 6c 7c 3a 5d 09 41 | 20 6c 61 62 65 6c 20 69 |bel|:].A| label i|
|00003670| 6e 64 69 63 61 74 69 6e | 67 20 74 68 65 20 73 65 |ndicatin|g the se|
|00003680| 63 75 72 69 74 79 20 70 | 6f 6c 69 63 79 2e 0a 0a |curity p|olicy...|
|00003690| 5c 69 74 65 6d 5b 5c 76 | 65 72 62 7c 70 72 6f 6f |\item[\v|erb|proo|
|000036a0| 66 5c 5f 6f 66 5c 5f 73 | 75 62 6d 69 73 73 69 6f |f\_of\_s|ubmissio|
|000036b0| 6e 7c 3a 5d 09 41 6e 20 | 69 6e 64 69 63 61 74 69 |n|:].An |indicati|
|000036c0| 6f 6e 20 6f 66 20 77 68 | 65 74 68 65 72 20 70 72 |on of wh|ether pr|
|000036d0| 6f 6f 66 0a 6f 66 20 73 | 75 62 6d 69 73 73 69 6f |oof.of s|ubmissio|
|000036e0| 6e 20 69 73 20 5c 6c 69 | 6e 65 62 72 65 61 6b 5b |n is \li|nebreak[|
|000036f0| 33 5d 20 72 65 71 75 69 | 72 65 64 2e 0a 0a 5c 69 |3] requi|red...\i|
|00003700| 74 65 6d 5b 5c 76 65 72 | 62 7c 70 65 72 5c 5f 6d |tem[\ver|b|per\_m|
|00003710| 65 73 73 61 67 65 5c 5f | 65 78 74 65 6e 73 69 6f |essage\_|extensio|
|00003720| 6e 73 7c 3a 5d 09 41 20 | 68 6f 6c 64 65 72 20 66 |ns|:].A |holder f|
|00003730| 6f 72 20 61 6e 79 20 61 | 64 64 69 74 69 6f 6e 61 |or any a|dditiona|
|00003740| 6c 0a 65 6c 65 6d 65 6e | 74 73 20 6f 66 20 74 68 |l.elemen|ts of th|
|00003750| 65 20 6d 65 73 73 61 67 | 65 2e 0a 0a 5c 69 74 65 |e messag|e...\ite|
|00003760| 6d 5b 5c 76 65 72 62 7c | 4f 61 64 64 72 65 73 73 |m[\verb||Oaddress|
|00003770| 7c 3a 5d 09 53 68 6f 75 | 6c 64 20 62 65 20 65 6d ||:].Shou|ld be em|
|00003780| 70 74 79 20 66 6f 72 20 | 73 75 62 6d 69 73 73 69 |pty for |submissi|
|00003790| 6f 6e 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 76 65 72 62 |on...\it|em[\verb|
|000037a0| 7c 52 61 64 64 72 65 73 | 73 7c 3a 5d 09 53 68 6f ||Raddres|s|:].Sho|
|000037b0| 75 6c 64 20 62 65 20 65 | 6d 70 74 79 20 66 6f 72 |uld be e|mpty for|
|000037c0| 20 73 75 62 6d 69 73 73 | 69 6f 6e 2e 0a 0a 5c 69 | submiss|ion...\i|
|000037d0| 74 65 6d 5b 5c 76 65 72 | 62 7c 69 6e 62 6f 75 6e |tem[\ver|b|inboun|
|000037e0| 64 7c 3a 5d 09 54 68 65 | 20 69 6e 62 6f 75 6e 64 |d|:].The| inbound|
|000037f0| 20 63 68 61 6e 6e 65 6c | 2f 6d 74 61 20 70 61 69 | channel|/mta pai|
|00003800| 72 0a 54 68 69 73 20 69 | 73 20 69 6d 70 6f 72 74 |r.This i|s import|
|00003810| 61 6e 74 20 61 73 20 74 | 68 69 73 20 63 6f 6e 74 |ant as t|his cont|
|00003820| 72 6f 6c 73 20 61 75 74 | 68 65 6e 74 69 63 61 74 |rols aut|henticat|
|00003830| 69 6f 6e 20 61 6e 64 20 | 61 75 74 68 6f 72 69 73 |ion and |authoris|
|00003840| 61 74 69 6f 6e 2e 0a 0a | 5c 69 74 65 6d 5b 5c 76 |ation...|\item[\v|
|00003850| 65 72 62 7c 6d 73 67 69 | 64 7c 3a 5d 09 54 68 65 |erb|msgi|d|:].The|
|00003860| 20 4d 54 53 20 69 64 65 | 6e 74 69 66 69 65 72 20 | MTS ide|ntifier |
|00003870| 6f 66 20 74 68 69 73 20 | 6d 65 73 73 61 67 65 20 |of this |message |
|00003880| 28 50 31 20 6c 65 76 65 | 6c 29 2e 0a 0a 5c 69 74 |(P1 leve|l)...\it|
|00003890| 65 6d 5b 5c 76 65 72 62 | 7c 74 72 61 63 65 7c 3a |em[\verb||trace|:|
|000038a0| 5d 09 54 68 65 20 74 72 | 61 63 65 20 66 69 65 6c |].The tr|ace fiel|
|000038b0| 64 73 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 76 65 72 62 |ds...\it|em[\verb|
|000038c0| 7c 64 6c 5c 5f 65 78 70 | 61 6e 73 69 6f 6e 5c 5f ||dl\_exp|ansion\_|
|000038d0| 68 69 73 74 6f 72 79 7c | 3a 5d 09 41 20 74 72 61 |history||:].A tra|
|000038e0| 63 65 20 6f 66 20 74 68 | 65 20 64 69 73 74 72 69 |ce of th|e distri|
|000038f0| 62 75 74 69 6f 6e 0a 6c | 69 73 74 73 20 74 68 69 |bution.l|ists thi|
|00003900| 73 20 6d 65 73 73 61 67 | 65 20 68 61 73 20 62 65 |s messag|e has be|
|00003910| 65 6e 20 65 78 70 61 6e | 64 65 64 20 62 79 2e 0a |en expan|ded by..|
|00003920| 0a 5c 65 6e 64 7b 64 65 | 73 63 72 69 62 65 7d 0a |.\end{de|scribe}.|
|00003930| 0a 5c 73 75 62 73 75 62 | 73 65 63 74 69 6f 6e 7b |.\subsub|section{|
|00003940| 54 68 65 20 41 64 64 72 | 65 73 73 20 73 74 72 75 |The Addr|ess stru|
|00003950| 63 74 75 72 65 7d 5c 69 | 6e 64 65 78 7b 61 64 64 |cture}\i|ndex{add|
|00003960| 72 65 73 73 69 6e 67 7d | 0a 0a 54 68 65 20 61 64 |ressing}|..The ad|
|00003970| 64 72 65 73 73 20 73 74 | 72 75 63 74 75 72 65 20 |dress st|ructure |
|00003980| 63 6f 6e 74 61 69 6e 73 | 20 61 6c 6c 20 74 68 65 |contains| all the|
|00003990| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 20 61 62 6f | informa|tion abo|
|000039a0| 75 74 20 65 61 63 68 20 | 61 64 64 72 65 73 73 2e |ut each |address.|
|000039b0| 0a 54 68 65 20 73 74 72 | 75 63 74 75 72 65 20 69 |.The str|ucture i|
|000039c0| 73 20 64 65 66 69 6e 65 | 64 20 69 6e 20 74 68 65 |s define|d in the|
|000039d0| 20 66 69 6c 65 20 5c 66 | 69 6c 65 7b 61 64 72 2e | file \f|ile{adr.|
|000039e0| 68 7d 2e 20 20 54 68 65 | 20 73 61 6d 65 20 73 74 |h}. The| same st|
|000039f0| 72 75 63 74 75 72 65 0a | 69 73 20 75 73 65 64 20 |ructure.|is used |
|00003a00| 66 6f 72 20 62 6f 74 68 | 20 52 65 63 69 70 69 65 |for both| Recipie|
|00003a10| 6e 74 20 61 6e 64 20 4f | 72 69 67 69 6e 61 74 6f |nt and O|riginato|
|00003a20| 72 20 61 64 64 72 65 73 | 73 2e 20 54 68 65 20 73 |r addres|s. The s|
|00003a30| 74 72 75 63 74 75 72 65 | 20 69 73 0a 73 68 6f 77 |tructure| is.show|
|00003a40| 6e 20 69 6e 20 46 69 67 | 75 72 65 7e 5c 72 65 66 |n in Fig|ure~\ref|
|00003a50| 7b 61 64 72 3a 73 74 72 | 75 63 74 7d 2e 20 54 68 |{adr:str|uct}. Th|
|00003a60| 65 72 65 20 61 72 65 20 | 61 20 6e 75 6d 62 65 72 |ere are |a number|
|00003a70| 20 6f 66 20 73 75 70 70 | 6f 72 74 0a 72 6f 75 74 | of supp|ort.rout|
|00003a80| 69 6e 65 73 20 74 68 61 | 74 20 68 65 6c 70 20 63 |ines tha|t help c|
|00003a90| 6f 6e 73 74 72 75 63 74 | 20 61 64 64 72 65 73 73 |onstruct| address|
|00003aa0| 65 73 2e 0a 0a 54 68 65 | 20 72 6f 75 74 69 6e 65 |es...The| routine|
|00003ab0| 20 5c 76 65 72 62 7c 61 | 64 72 5f 6e 65 77 7c 20 | \verb|a|dr_new| |
|00003ac0| 63 72 65 61 74 65 73 20 | 61 20 6e 65 77 20 61 64 |creates |a new ad|
|00003ad0| 64 72 65 73 73 20 73 74 | 72 75 63 74 75 72 65 20 |dress st|ructure |
|00003ae0| 77 69 74 68 20 73 6f 6d | 65 0a 6f 66 20 74 68 65 |with som|e.of the|
|00003af0| 20 76 61 6c 75 65 73 20 | 66 69 6c 6c 65 64 20 69 | values |filled i|
|00003b00| 6e 2e 20 54 68 69 73 20 | 73 74 72 75 63 74 75 72 |n. This |structur|
|00003b10| 65 20 69 73 20 74 68 65 | 20 6d 69 6e 69 6d 75 6d |e is the| minimum|
|00003b20| 20 6e 65 63 65 73 73 61 | 72 79 20 73 65 74 0a 6f | necessa|ry set.o|
|00003b30| 66 20 76 61 6c 75 65 73 | 20 74 6f 20 73 75 62 6d |f values| to subm|
|00003b40| 69 74 20 61 20 72 65 63 | 69 70 69 65 6e 74 2e 20 |it a rec|ipient. |
|00003b50| 54 6f 20 63 72 65 61 74 | 65 20 61 6e 20 4f 72 69 |To creat|e an Ori|
|00003b60| 67 69 6e 61 74 6f 72 2c | 20 74 68 65 0a 72 65 73 |ginator,| the.res|
|00003b70| 70 6f 6e 73 69 62 69 6c | 69 74 79 20 62 69 74 20 |ponsibil|ity bit |
|00003b80| 5c 76 65 72 62 7c 61 64 | 5f 72 65 73 70 7c 20 73 |\verb|ad|_resp| s|
|00003b90| 68 6f 75 6c 64 20 62 65 | 20 73 65 74 20 74 6f 20 |hould be| set to |
|00003ba0| 66 61 6c 73 65 2c 20 61 | 6e 64 20 74 68 65 0a 73 |false, a|nd the.s|
|00003bb0| 74 61 74 75 73 20 28 5c | 76 65 72 62 7c 61 64 5f |tatus (\|verb|ad_|
|00003bc0| 73 74 61 74 7c 29 20 73 | 68 6f 75 6c 64 20 62 65 |stat|) s|hould be|
|00003bd0| 20 73 65 74 20 74 6f 20 | 5c 76 65 72 62 7c 41 44 | set to |\verb|AD|
|00003be0| 5f 53 54 41 54 5f 44 4f | 4e 45 7c 2e 0a 54 68 65 |_STAT_DO|NE|..The|
|00003bf0| 20 72 6f 75 74 69 6e 65 | 20 69 73 20 64 65 66 69 | routine| is defi|
|00003c00| 6e 65 64 20 61 73 3a 0a | 5c 62 65 67 69 6e 7b 71 |ned as:.|\begin{q|
|00003c10| 75 6f 74 65 7d 5c 73 6d | 61 6c 6c 5c 69 6e 64 65 |uote}\sm|all\inde|
|00003c20| 78 7b 61 64 72 5c 5f 6e | 65 77 7d 5c 62 65 67 69 |x{adr\_n|ew}\begi|
|00003c30| 6e 7b 76 65 72 62 61 74 | 69 6d 7d 0a 41 44 44 52 |n{verbat|im}.ADDR|
|00003c40| 20 2a 61 64 72 5f 6e 65 | 77 20 28 73 74 72 2c 20 | *adr_ne|w (str, |
|00003c50| 74 79 70 65 2c 20 72 6e | 6f 29 0a 63 68 61 72 20 |type, rn|o).char |
|00003c60| 2a 73 74 72 3b 0a 69 6e | 74 20 74 79 70 65 3b 0a |*str;.in|t type;.|
|00003c70| 69 6e 74 20 72 6e 6f 3b | 0a 5c 65 6e 64 7b 76 65 |int rno;|.\end{ve|
|00003c80| 72 62 61 74 69 6d 7d 5c | 65 6e 64 7b 71 75 6f 74 |rbatim}\|end{quot|
|00003c90| 65 7d 0a 54 68 65 20 61 | 72 67 75 6d 65 6e 74 73 |e}.The a|rguments|
|00003ca0| 20 74 6f 20 74 68 69 73 | 20 63 61 6c 6c 20 61 72 | to this| call ar|
|00003cb0| 65 0a 5c 62 65 67 69 6e | 7b 64 65 73 63 72 69 62 |e.\begin|{describ|
|00003cc0| 65 7d 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 7c 73 |e}.\item|[\verb|s|
|00003cd0| 74 72 7c 3a 5d 20 54 68 | 65 20 61 64 64 72 65 73 |tr|:] Th|e addres|
|00003ce0| 73 20 69 6e 20 73 74 72 | 69 6e 67 20 66 6f 72 6d |s in str|ing form|
|00003cf0| 61 74 2c 20 65 69 74 68 | 65 72 20 52 46 43 7e 38 |at, eith|er RFC~8|
|00003d00| 32 32 20 6f 72 20 74 68 | 65 0a 73 74 72 69 6e 67 |22 or th|e.string|
|00003d10| 20 66 6f 72 6d 20 6f 66 | 20 74 68 65 20 4f 2f 52 | form of| the O/R|
|00003d20| 20 6e 61 6d 65 2e 0a 5c | 69 74 65 6d 5b 5c 76 65 | name..\|item[\ve|
|00003d30| 72 62 7c 74 79 70 65 7c | 3a 5d 20 54 68 69 73 20 |rb|type||:] This |
|00003d40| 69 73 20 74 68 65 20 74 | 79 70 65 20 6f 66 20 61 |is the t|ype of a|
|00003d50| 64 64 72 65 73 73 3b 20 | 69 74 20 73 68 6f 75 6c |ddress; |it shoul|
|00003d60| 64 20 62 65 20 6f 6e 65 | 20 6f 66 0a 74 68 65 20 |d be one| of.the |
|00003d70| 76 61 6c 75 65 73 20 73 | 75 69 74 61 62 6c 65 20 |values s|uitable |
|00003d80| 66 6f 72 20 5c 76 65 72 | 62 7c 61 64 5f 74 79 70 |for \ver|b|ad_typ|
|00003d90| 65 7c 2e 0a 5c 69 74 65 | 6d 5b 5c 76 65 72 62 7c |e|..\ite|m[\verb||
|00003da0| 72 6e 6f 7c 3a 5d 20 54 | 68 65 20 72 65 63 69 70 |rno|:] T|he recip|
|00003db0| 69 65 6e 74 20 6e 75 6d | 62 65 72 2e 20 53 65 74 |ient num|ber. Set|
|00003dc0| 20 74 68 69 73 20 74 6f | 20 30 20 69 66 20 79 6f | this to| 0 if yo|
|00003dd0| 75 20 64 6f 20 6e 6f 74 | 0a 63 61 72 65 20 61 62 |u do not|.care ab|
|00003de0| 6f 75 74 20 74 68 69 73 | 20 76 61 6c 75 65 2e 0a |out this| value..|
|00003df0| 5c 65 6e 64 7b 64 65 73 | 63 72 69 62 65 7d 0a 0a |\end{des|cribe}..|
|00003e00| 54 68 65 20 72 6f 75 74 | 69 6e 65 20 5c 76 65 72 |The rout|ine \ver|
|00003e10| 62 7c 61 64 5f 69 6e 69 | 74 7c 20 77 69 6c 6c 20 |b|ad_ini|t| will |
|00003e20| 69 6e 69 74 69 61 6c 69 | 73 65 20 61 6e 20 5c 76 |initiali|se an \v|
|00003e30| 65 72 62 7c 41 44 44 52 | 7c 20 73 74 72 75 63 74 |erb|ADDR|| struct|
|00003e40| 75 72 65 20 74 6f 0a 69 | 74 73 20 64 65 66 61 75 |ure to.i|ts defau|
|00003e50| 6c 74 20 76 61 6c 75 65 | 73 2e 20 49 74 20 69 73 |lt value|s. It is|
|00003e60| 20 64 65 66 69 6e 65 64 | 20 61 73 3a 0a 5c 62 65 | defined| as:.\be|
|00003e70| 67 69 6e 7b 71 75 6f 74 | 65 7d 5c 73 6d 61 6c 6c |gin{quot|e}\small|
|00003e80| 5c 69 6e 64 65 78 7b 61 | 64 72 5c 5f 69 6e 69 74 |\index{a|dr\_init|
|00003e90| 7d 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |}\begin{|verbatim|
|00003ea0| 7d 0a 76 6f 69 64 20 61 | 64 72 5f 69 6e 69 74 20 |}.void a|dr_init |
|00003eb0| 28 61 70 29 0a 41 44 44 | 52 20 2a 61 70 3b 0a 5c |(ap).ADD|R *ap;.\|
|00003ec0| 65 6e 64 7b 76 65 72 62 | 61 74 69 6d 7d 5c 65 6e |end{verb|atim}\en|
|00003ed0| 64 7b 71 75 6f 74 65 7d | 0a 0a 54 68 65 20 72 6f |d{quote}|..The ro|
|00003ee0| 75 74 69 6e 65 20 5c 76 | 65 72 62 7c 61 64 72 5f |utine \v|erb|adr_|
|00003ef0| 61 64 64 7c 20 61 64 64 | 73 20 61 6e 20 61 64 64 |add| add|s an add|
|00003f00| 72 65 73 73 20 6f 6e 74 | 6f 20 74 68 65 20 65 6e |ress ont|o the en|
|00003f10| 64 20 6f 66 20 61 20 6c | 69 6e 6b 65 64 0a 6c 69 |d of a l|inked.li|
|00003f20| 73 74 20 6f 66 20 61 64 | 64 72 65 73 73 65 73 2c |st of ad|dresses,|
|00003f30| 20 6f 72 20 61 6c 6c 6f | 63 61 74 65 73 20 74 68 | or allo|cates th|
|00003f40| 65 20 66 69 72 73 74 20 | 6e 6f 64 65 20 69 66 20 |e first |node if |
|00003f50| 74 68 65 20 6c 69 73 74 | 20 69 73 20 65 6d 70 74 |the list| is empt|
|00003f60| 79 2e 0a 5c 62 65 67 69 | 6e 7b 71 75 6f 74 65 7d |y..\begi|n{quote}|
|00003f70| 5c 73 6d 61 6c 6c 5c 69 | 6e 64 65 78 7b 61 64 72 |\small\i|ndex{adr|
|00003f80| 5c 5f 61 64 64 7d 5c 62 | 65 67 69 6e 7b 76 65 72 |\_add}\b|egin{ver|
|00003f90| 62 61 74 69 6d 7d 0a 76 | 6f 69 64 20 61 64 72 5f |batim}.v|oid adr_|
|00003fa0| 61 64 64 20 28 62 61 73 | 65 2c 20 6e 65 77 29 0a |add (bas|e, new).|
|00003fb0| 41 44 44 52 20 2a 2a 62 | 61 73 65 3b 0a 41 44 44 |ADDR **b|ase;.ADD|
|00003fc0| 52 20 2a 6e 65 77 3b 0a | 5c 65 6e 64 7b 76 65 72 |R *new;.|\end{ver|
|00003fd0| 62 61 74 69 6d 7d 5c 65 | 6e 64 7b 71 75 6f 74 65 |batim}\e|nd{quote|
|00003fe0| 7d 0a 0a 54 68 65 20 72 | 6f 75 74 69 6e 65 20 5c |}..The r|outine \|
|00003ff0| 76 65 72 62 7c 61 64 72 | 5f 74 66 72 65 65 7c 20 |verb|adr|_tfree| |
|00004000| 66 72 65 65 73 20 61 20 | 6c 69 73 74 20 6f 66 20 |frees a |list of |
|00004010| 61 64 64 72 65 73 73 65 | 73 20 66 72 65 65 69 6e |addresse|s freein|
|00004020| 67 20 6f 66 20 61 6c 6c | 0a 61 6c 6c 6f 63 61 74 |g of all|.allocat|
|00004030| 65 64 20 65 6c 65 6d 65 | 6e 74 73 20 61 6e 64 20 |ed eleme|nts and |
|00004040| 74 68 65 20 73 74 72 75 | 63 74 75 72 65 73 20 74 |the stru|ctures t|
|00004050| 68 65 6d 73 65 6c 76 65 | 73 2e 0a 5c 62 65 67 69 |hemselve|s..\begi|
|00004060| 6e 7b 71 75 6f 74 65 7d | 5c 73 6d 61 6c 6c 5c 69 |n{quote}|\small\i|
|00004070| 6e 64 65 78 7b 61 64 72 | 5c 5f 74 66 72 65 65 7d |ndex{adr|\_tfree}|
|00004080| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00004090| 0a 76 6f 69 64 20 61 64 | 72 5f 74 66 72 65 65 20 |.void ad|r_tfree |
|000040a0| 28 61 70 29 0a 41 44 44 | 52 20 2a 61 70 3b 0a 5c |(ap).ADD|R *ap;.\|
|000040b0| 65 6e 64 7b 76 65 72 62 | 61 74 69 6d 7d 5c 65 6e |end{verb|atim}\en|
|000040c0| 64 7b 71 75 6f 74 65 7d | 0a 0a 54 68 65 20 72 6f |d{quote}|..The ro|
|000040d0| 75 74 69 6e 65 20 5c 76 | 65 72 62 7c 61 64 72 5f |utine \v|erb|adr_|
|000040e0| 66 72 65 65 7c 20 66 72 | 65 65 73 20 6f 66 66 20 |free| fr|ees off |
|000040f0| 61 6c 6c 20 74 68 65 20 | 61 6c 6c 6f 63 61 74 65 |all the |allocate|
|00004100| 64 20 65 6c 65 6d 65 6e | 74 73 0a 77 69 74 68 69 |d elemen|ts.withi|
|00004110| 6e 20 61 20 73 69 6e 67 | 6c 65 20 61 64 64 72 65 |n a sing|le addre|
|00004120| 73 73 20 73 74 72 75 63 | 74 75 72 65 20 62 75 74 |ss struc|ture but|
|00004130| 20 64 6f 65 73 20 6e 6f | 74 20 66 72 65 65 20 74 | does no|t free t|
|00004140| 68 65 20 73 74 72 75 63 | 74 75 72 65 0a 69 74 73 |he struc|ture.its|
|00004150| 65 6c 66 2e 0a 5c 62 65 | 67 69 6e 7b 71 75 6f 74 |elf..\be|gin{quot|
|00004160| 65 7d 5c 73 6d 61 6c 6c | 5c 69 6e 64 65 78 7b 61 |e}\small|\index{a|
|00004170| 64 72 5c 5f 66 72 65 65 | 7d 5c 62 65 67 69 6e 7b |dr\_free|}\begin{|
|00004180| 76 65 72 62 61 74 69 6d | 7d 0a 76 6f 69 64 20 61 |verbatim|}.void a|
|00004190| 64 72 5f 66 72 65 65 20 | 28 61 70 29 0a 41 44 44 |dr_free |(ap).ADD|
|000041a0| 52 20 2a 61 70 3b 0a 5c | 65 6e 64 7b 76 65 72 62 |R *ap;.\|end{verb|
|000041b0| 61 74 69 6d 7d 5c 65 6e | 64 7b 71 75 6f 74 65 7d |atim}\en|d{quote}|
|000041c0| 0a 0a 5c 62 69 67 73 6b | 69 70 0a 0a 5c 74 61 67 |..\bigsk|ip..\tag|
|000041d0| 72 69 6e 64 66 69 6c 65 | 7b 61 64 72 73 74 72 75 |rindfile|{adrstru|
|000041e0| 63 74 7d 7b 41 64 64 72 | 65 73 73 20 53 74 72 75 |ct}{Addr|ess Stru|
|000041f0| 63 74 75 72 65 7d 7b 61 | 64 72 3a 73 74 72 75 63 |cture}{a|dr:struc|
|00004200| 74 7d 0a 0a 4f 6e 6c 79 | 20 74 68 65 20 6e 6f 6e |t}..Only| the non|
|00004210| 2d 69 6e 74 65 72 6e 61 | 6c 20 66 69 65 6c 64 73 |-interna|l fields|
|00004220| 20 61 72 65 20 64 65 73 | 63 72 69 62 65 64 20 68 | are des|cribed h|
|00004230| 65 72 65 3a 0a 5c 62 65 | 67 69 6e 7b 64 65 73 63 |ere:.\be|gin{desc|
|00004240| 72 69 62 65 7d 5c 69 6e | 64 65 78 7b 61 64 64 72 |ribe}\in|dex{addr|
|00004250| 65 73 73 20 73 74 72 75 | 63 74 75 72 65 7d 5c 69 |ess stru|cture}\i|
|00004260| 6e 64 65 78 7b 41 44 44 | 52 7d 0a 0a 5c 69 74 65 |ndex{ADD|R}..\ite|
|00004270| 6d 5b 5c 76 65 72 62 7c | 61 64 5c 5f 65 78 74 65 |m[\verb||ad\_exte|
|00004280| 6e 73 69 6f 6e 7c 3a 5d | 09 54 68 65 20 65 78 74 |nsion|:]|.The ext|
|00004290| 65 6e 73 69 6f 6e 20 69 | 64 65 6e 74 69 66 69 65 |ension i|dentifie|
|000042a0| 72 20 66 6f 72 20 74 68 | 69 73 20 61 64 64 72 65 |r for th|is addre|
|000042b0| 73 73 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 76 65 72 62 |ss...\it|em[\verb|
|000042c0| 7c 61 64 5c 5f 73 74 61 | 74 75 73 7c 3a 5d 09 54 ||ad\_sta|tus|:].T|
|000042d0| 68 65 20 73 74 61 74 75 | 73 20 6f 66 20 74 68 69 |he statu|s of thi|
|000042e0| 73 20 61 64 64 72 65 73 | 73 2c 20 6f 6e 65 20 6f |s addres|s, one o|
|000042f0| 66 3a 0a 5c 5b 5c 62 65 | 67 69 6e 7b 74 61 62 75 |f:.\[\be|gin{tabu|
|00004300| 6c 61 72 7d 7b 7c 6c 7c | 6c 7c 7d 0a 5c 68 6c 69 |lar}{|l||l|}.\hli|
|00004310| 6e 65 0a 09 5c 6d 75 6c | 74 69 63 6f 6c 75 6d 6e |ne..\mul|ticolumn|
|00004320| 7b 31 7d 7b 7c 63 7c 7d | 7b 5c 62 66 20 56 61 6c |{1}{|c|}|{\bf Val|
|00004330| 75 65 7d 26 0a 09 09 5c | 6d 75 6c 74 69 63 6f 6c |ue}&...\|multicol|
|00004340| 75 6d 6e 7b 31 7d 7b 7c | 63 7c 7d 7b 5c 62 66 20 |umn{1}{||c|}{\bf |
|00004350| 4d 65 61 6e 69 6e 67 7d | 5c 5c 0a 5c 68 6c 69 6e |Meaning}|\\.\hlin|
|00004360| 65 0a 09 5c 74 74 20 41 | 44 5c 5f 53 54 41 54 5c |e..\tt A|D\_STAT\|
|00004370| 5f 50 45 4e 44 26 09 66 | 6f 72 20 72 65 63 69 70 |_PEND&.f|or recip|
|00004380| 69 65 6e 74 73 20 61 77 | 61 69 74 69 6e 67 20 64 |ients aw|aiting d|
|00004390| 65 6c 69 76 65 72 79 5c | 5c 0a 09 5c 74 74 20 41 |elivery\|\..\tt A|
|000043a0| 44 5c 5f 53 54 41 54 5c | 5f 44 4f 4e 45 26 09 66 |D\_STAT\|_DONE&.f|
|000043b0| 6f 72 20 72 65 63 69 70 | 69 65 6e 74 73 20 6e 6f |or recip|ients no|
|000043c0| 74 20 74 6f 20 62 65 20 | 64 65 6c 69 76 65 72 65 |t to be |delivere|
|000043d0| 64 20 74 6f 5c 5c 0a 5c | 68 6c 69 6e 65 0a 5c 65 |d to\\.\|hline.\e|
|000043e0| 6e 64 7b 74 61 62 75 6c | 61 72 7d 5c 5d 0a 0a 5c |nd{tabul|ar}\]..\|
|000043f0| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 61 64 5c 5f 64 |item[\ve|rb|ad\_d|
|00004400| 6e 7c 3a 5d 09 54 68 65 | 20 64 69 73 74 69 6e 67 |n|:].The| disting|
|00004410| 75 69 73 68 65 64 20 6e | 61 6d 65 20 63 6f 6d 70 |uished n|ame comp|
|00004420| 6f 6e 65 6e 74 20 6f 66 | 20 74 68 65 20 61 64 64 |onent of| the add|
|00004430| 72 65 73 73 2e 0a 0a 5c | 69 74 65 6d 5b 5c 76 65 |ress...\|item[\ve|
|00004440| 72 62 7c 61 64 5c 5f 75 | 73 72 72 65 71 7c 3a 5d |rb|ad\_u|srreq|:]|
|00004450| 09 54 68 69 73 20 6d 61 | 70 73 20 74 6f 20 74 68 |.This ma|ps to th|
|00004460| 65 20 58 2e 34 30 30 20 | 75 73 65 72 20 72 65 71 |e X.400 |user req|
|00004470| 75 65 73 74 0a 62 69 74 | 73 2e 20 49 74 20 68 61 |uest.bit|s. It ha|
|00004480| 73 20 74 68 65 20 6f 6e | 65 20 6f 66 20 74 68 65 |s the on|e of the|
|00004490| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 76 61 6c 75 65 | followi|ng value|
|000044a0| 73 3a 0a 5c 5b 5c 62 65 | 67 69 6e 7b 74 61 62 75 |s:.\[\be|gin{tabu|
|000044b0| 6c 61 72 7d 7b 7c 6c 7c | 6c 7c 7d 0a 5c 68 6c 69 |lar}{|l||l|}.\hli|
|000044c0| 6e 65 0a 09 5c 6d 75 6c | 74 69 63 6f 6c 75 6d 6e |ne..\mul|ticolumn|
|000044d0| 7b 31 7d 7b 7c 63 7c 7d | 7b 5c 62 66 20 56 61 6c |{1}{|c|}|{\bf Val|
|000044e0| 75 65 7d 26 0a 09 09 5c | 6d 75 6c 74 69 63 6f 6c |ue}&...\|multicol|
|000044f0| 75 6d 6e 7b 31 7d 7b 7c | 63 7c 7d 7b 5c 62 66 20 |umn{1}{||c|}{\bf |
|00004500| 4d 65 61 6e 69 6e 67 7d | 5c 5c 0a 5c 68 6c 69 6e |Meaning}|\\.\hlin|
|00004510| 65 0a 09 5c 74 74 20 41 | 44 5c 5f 55 53 52 5c 5f |e..\tt A|D\_USR\_|
|00004520| 4e 4f 52 45 50 4f 52 54 | 26 20 09 4e 6f 20 64 65 |NOREPORT|& .No de|
|00004530| 6c 69 76 65 72 79 20 72 | 65 70 6f 72 74 73 20 72 |livery r|eports r|
|00004540| 65 71 75 65 73 74 65 64 | 5c 5c 0a 09 5c 74 74 20 |equested|\\..\tt |
|00004550| 41 44 5c 5f 55 53 52 5c | 5f 42 41 53 49 43 26 20 |AD\_USR\|_BASIC& |
|00004560| 09 44 65 6c 69 76 65 72 | 79 20 66 61 69 6c 75 74 |.Deliver|y failut|
|00004570| 65 73 20 73 68 6f 75 6c | 64 20 62 65 20 72 65 70 |es shoul|d be rep|
|00004580| 6f 72 74 65 64 5c 5c 0a | 09 5c 74 74 20 41 44 5c |orted\\.|.\tt AD\|
|00004590| 5f 55 53 52 5c 5f 43 4f | 4e 46 49 52 4d 26 09 44 |_USR\_CO|NFIRM&.D|
|000045a0| 65 6c 69 76 65 72 69 65 | 73 20 73 68 6f 75 6c 64 |eliverie|s should|
|000045b0| 20 62 65 20 63 6f 6e 66 | 69 72 6d 65 64 5c 5c 0a | be conf|irmed\\.|
|000045c0| 09 5c 74 74 20 41 44 5c | 5f 55 53 52 5c 5f 4e 4f |.\tt AD\|_USR\_NO|
|000045d0| 4e 45 26 09 55 6e 64 65 | 66 69 6e 65 64 20 76 61 |NE&.Unde|fined va|
|000045e0| 6c 75 65 5c 5c 0a 5c 68 | 6c 69 6e 65 0a 5c 65 6e |lue\\.\h|line.\en|
|000045f0| 64 7b 74 61 62 75 6c 61 | 72 7d 5c 5d 0a 0a 5c 69 |d{tabula|r}\]..\i|
|00004600| 74 65 6d 5b 5c 76 65 72 | 62 7c 61 64 5c 5f 65 78 |tem[\ver|b|ad\_ex|
|00004610| 70 6c 69 63 69 74 63 6f | 6e 76 65 72 73 69 6f 6e |plicitco|nversion|
|00004620| 7c 3a 5d 09 49 73 20 65 | 78 70 6c 69 63 69 74 20 ||:].Is e|xplicit |
|00004630| 63 6f 6e 76 65 72 73 69 | 6f 6e 0a 72 65 71 75 69 |conversi|on.requi|
|00004640| 72 65 64 2e 20 49 74 20 | 73 68 6f 75 6c 64 20 62 |red. It |should b|
|00004650| 65 20 6f 6e 65 20 6f 66 | 20 74 68 65 20 76 61 6c |e one of| the val|
|00004660| 75 65 73 20 64 65 66 69 | 6e 65 64 20 69 6e 0a 54 |ues defi|ned in.T|
|00004670| 61 62 6c 65 7e 5c 72 65 | 66 7b 74 62 6c 3a 65 78 |able~\re|f{tbl:ex|
|00004680| 70 6c 69 63 69 74 7d 2e | 0a 0a 5c 74 61 67 74 61 |plicit}.|..\tagta|
|00004690| 62 6c 65 7b 65 78 70 6c | 69 63 69 74 7d 7b 54 61 |ble{expl|icit}{Ta|
|000046a0| 62 6c 65 20 6f 66 20 45 | 78 70 6c 69 63 69 74 20 |ble of E|xplicit |
|000046b0| 43 6f 6e 76 65 72 73 69 | 6f 6e 20 56 61 6c 75 65 |Conversi|on Value|
|000046c0| 73 7d 7b 74 62 6c 3a 65 | 78 70 6c 69 63 69 74 7d |s}{tbl:e|xplicit}|
|000046d0| 0a 0a 5c 69 74 65 6d 5b | 5c 76 65 72 62 7c 61 64 |..\item[|\verb|ad|
|000046e0| 5c 5f 74 79 70 65 7c 3a | 5d 09 54 68 65 20 61 64 |\_type|:|].The ad|
|000046f0| 64 72 65 73 73 20 74 79 | 70 65 2e 20 54 68 69 73 |dress ty|pe. This|
|00004700| 20 69 73 20 6f 6e 65 20 | 6f 66 20 74 68 65 20 66 | is one |of the f|
|00004710| 6f 6c 6c 6f 77 69 6e 67 | 0a 76 61 6c 75 65 73 3a |ollowing|.values:|
|00004720| 20 0a 5c 5b 5c 62 65 67 | 69 6e 7b 74 61 62 75 6c | .\[\beg|in{tabul|
|00004730| 61 72 7d 7b 7c 6c 7c 6c | 7c 7d 0a 5c 68 6c 69 6e |ar}{|l|l||}.\hlin|
|00004740| 65 0a 09 5c 6d 75 6c 74 | 69 63 6f 6c 75 6d 6e 7b |e..\mult|icolumn{|
|00004750| 31 7d 7b 7c 63 7c 7d 7b | 5c 62 66 20 56 61 6c 75 |1}{|c|}{|\bf Valu|
|00004760| 65 7d 26 0a 09 09 5c 6d | 75 6c 74 69 63 6f 6c 75 |e}&...\m|ulticolu|
|00004770| 6d 6e 7b 31 7d 7b 7c 63 | 7c 7d 7b 5c 62 66 20 4d |mn{1}{|c||}{\bf M|
|00004780| 65 61 6e 69 6e 67 7d 5c | 5c 0a 5c 68 6c 69 6e 65 |eaning}\|\.\hline|
|00004790| 0a 09 5c 74 74 20 41 44 | 5c 5f 58 34 30 30 5c 5f |..\tt AD|\_X400\_|
|000047a0| 54 59 50 45 26 09 41 6e | 20 58 2e 34 30 30 20 66 |TYPE&.An| X.400 f|
|000047b0| 6f 72 6d 61 74 20 61 64 | 64 72 65 73 73 5c 5c 0a |ormat ad|dress\\.|
|000047c0| 09 5c 74 74 20 41 44 5c | 5f 38 32 32 5c 5f 54 59 |.\tt AD\|_822\_TY|
|000047d0| 50 45 26 09 41 6e 20 52 | 46 43 7e 38 32 32 20 66 |PE&.An R|FC~822 f|
|000047e0| 6f 72 6d 61 74 20 61 64 | 64 72 65 73 73 5c 5c 0a |ormat ad|dress\\.|
|000047f0| 09 5c 74 74 20 41 44 5c | 5f 41 4e 59 5c 5f 54 59 |.\tt AD\|_ANY\_TY|
|00004800| 50 45 26 09 41 6e 20 61 | 64 64 72 65 73 73 20 69 |PE&.An a|ddress i|
|00004810| 6e 20 61 6e 79 20 6f 66 | 20 74 68 65 20 61 62 6f |n any of| the abo|
|00004820| 76 65 20 66 6f 72 6d 61 | 74 73 5c 5c 0a 5c 68 6c |ve forma|ts\\.\hl|
|00004830| 69 6e 65 0a 5c 65 6e 64 | 7b 74 61 62 75 6c 61 72 |ine.\end|{tabular|
|00004840| 7d 5c 5d 0a 0a 5c 69 74 | 65 6d 5b 5c 76 65 72 62 |}\]..\it|em[\verb|
|00004850| 7c 61 64 5c 5f 6f 72 69 | 67 5c 5f 72 65 71 5c 5f ||ad\_ori|g\_req\_|
|00004860| 61 6c 74 7c 3a 5d 09 54 | 68 65 20 6f 72 69 67 69 |alt|:].T|he origi|
|00004870| 6e 61 74 6f 72 20 72 65 | 71 75 65 73 74 65 64 20 |nator re|quested |
|00004880| 61 6c 74 65 72 6e 61 74 | 65 0a 72 65 63 69 70 69 |alternat|e.recipi|
|00004890| 65 6e 74 2c 20 69 66 20 | 73 75 70 70 6c 69 65 64 |ent, if |supplied|
|000048a0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 7c 61 |...\item|[\verb|a|
|000048b0| 64 5c 5f 72 65 71 5c 5f | 64 65 6c 7c 3a 5d 09 54 |d\_req\_|del|:].T|
|000048c0| 68 65 20 72 65 71 75 65 | 73 74 65 64 20 64 65 6c |he reque|sted del|
|000048d0| 69 76 65 72 79 20 6d 65 | 74 68 6f 64 2e 20 54 68 |ivery me|thod. Th|
|000048e0| 69 73 20 69 73 0a 61 6e | 20 61 72 72 61 79 20 6f |is is.an| array o|
|000048f0| 66 20 64 65 6c 69 76 65 | 72 79 20 6d 65 74 68 6f |f delive|ry metho|
|00004900| 64 20 61 6c 74 65 72 6e | 61 74 69 76 65 73 2e 0a |d altern|atives..|
|00004910| 0a 5c 69 74 65 6d 5b 5c | 76 65 72 62 7c 61 64 5c |.\item[\|verb|ad\|
|00004920| 5f 70 68 79 73 5c 5f 66 | 6f 72 77 61 72 64 7c 3a |_phys\_f|orward|:|
|00004930| 5d 20 49 66 20 70 68 79 | 73 69 63 61 6c 20 66 6f |] If phy|sical fo|
|00004940| 72 77 61 72 64 69 6e 67 | 20 69 73 20 61 6c 6c 6f |rwarding| is allo|
|00004950| 77 65 64 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 76 65 72 |wed...\i|tem[\ver|
|00004960| 62 7c 61 64 5c 5f 70 68 | 79 73 5c 5f 66 77 5c 5f |b|ad\_ph|ys\_fw\_|
|00004970| 61 64 5c 5f 72 65 71 7c | 3a 5d 09 41 20 72 65 71 |ad\_req||:].A req|
|00004980| 75 65 73 74 20 74 6f 20 | 73 75 70 70 6c 79 20 74 |uest to |supply t|
|00004990| 68 65 0a 70 68 79 73 69 | 63 61 6c 20 66 6f 72 77 |he.physi|cal forw|
|000049a0| 61 72 64 69 6e 67 20 61 | 64 64 72 65 73 73 20 6f |arding a|ddress o|
|000049b0| 66 20 74 68 65 20 72 65 | 63 69 70 69 65 6e 74 2e |f the re|cipient.|
|000049c0| 0a 0a 5c 69 74 65 6d 5b | 5c 76 65 72 62 7c 61 64 |..\item[|\verb|ad|
|000049d0| 5c 5f 70 68 79 73 5c 5f | 6d 6f 64 65 73 7c 3a 5d |\_phys\_|modes|:]|
|000049e0| 20 53 70 65 63 69 66 69 | 65 73 20 74 68 65 20 74 | Specifi|es the t|
|000049f0| 79 70 65 20 6f 66 20 64 | 65 6c 69 76 65 72 79 20 |ype of d|elivery |
|00004a00| 72 65 71 75 69 72 65 64 | 2e 0a 0a 5c 69 74 65 6d |required|...\item|
|00004a10| 5b 5c 76 65 72 62 7c 61 | 64 5c 5f 72 65 67 5c 5f |[\verb|a|d\_reg\_|
|00004a20| 6d 61 69 6c 5c 5f 74 79 | 70 65 7c 3a 5d 09 54 68 |mail\_ty|pe|:].Th|
|00004a30| 65 20 74 79 70 65 20 6f | 66 20 72 65 67 69 73 74 |e type o|f regist|
|00004a40| 65 72 65 64 20 6d 61 69 | 6c 20 69 6e 0a 75 73 65 |ered mai|l in.use|
|00004a50| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 76 65 72 62 7c 61 |...\item|[\verb|a|
|00004a60| 64 5c 5f 72 65 63 69 70 | 5c 5f 6e 75 6d 62 65 72 |d\_recip|\_number|
|00004a70| 5c 5f 66 6f 72 5c 5f 61 | 64 76 69 63 65 7c 3a 5d |\_for\_a|dvice|:]|
|00004a80| 09 54 68 65 20 6e 75 6d | 62 65 72 20 66 6f 72 20 |.The num|ber for |
|00004a90| 61 64 76 69 63 65 0a 74 | 6f 20 63 61 6c 6c 20 66 |advice.t|o call f|
|00004aa0| 6f 72 20 64 65 6c 69 76 | 65 72 79 2e 0a 0a 5c 69 |or deliv|ery...\i|
|00004ab0| 74 65 6d 5b 5c 76 65 72 | 62 7c 61 64 5c 5f 70 68 |tem[\ver|b|ad\_ph|
|00004ac0| 79 73 5c 5f 72 65 6e 64 | 69 74 69 6f 6e 5c 5f 61 |ys\_rend|ition\_a|
|00004ad0| 74 74 72 69 62 75 74 65 | 7c 3a 5d 09 54 68 65 20 |ttribute||:].The |
|00004ae0| 70 68 79 73 69 63 61 6c | 20 72 65 6e 64 69 74 69 |physical| renditi|
|00004af0| 6f 6e 0a 61 74 74 72 69 | 62 75 74 65 73 20 66 6f |on.attri|butes fo|
|00004b00| 72 20 74 68 65 20 5c 6c | 69 6e 65 62 72 65 61 6b |r the \l|inebreak|
|00004b10| 5b 33 5d 20 61 64 64 72 | 65 73 73 20 77 68 65 6e |[3] addr|ess when|
|00004b20| 20 74 72 61 6e 73 66 65 | 72 65 64 20 74 6f 20 74 | transfe|red to t|
|00004b30| 68 65 20 70 6f 73 74 61 | 6c 20 73 65 72 76 69 63 |he posta|l servic|
|00004b40| 65 2e 0a 0a 5c 69 74 65 | 6d 5b 5c 76 65 72 62 7c |e...\ite|m[\verb||
|00004b50| 61 64 5c 5f 70 64 5c 5f | 72 65 70 6f 72 74 5c 5f |ad\_pd\_|report\_|
|00004b60| 72 65 71 75 65 73 74 7c | 3a 5d 20 41 6e 20 6f 70 |request||:] An op|
|00004b70| 74 69 6f 6e 20 74 6f 20 | 73 75 70 70 6c 79 20 61 |tion to |supply a|
|00004b80| 20 70 68 79 73 69 63 61 | 6c 0a 64 65 6c 69 76 65 | physica|l.delive|
|00004b90| 72 79 20 72 65 70 6f 72 | 74 2e 0a 0a 5c 69 74 65 |ry repor|t...\ite|
|00004ba0| 6d 5b 5c 76 65 72 62 7c | 61 64 5c 5f 72 65 64 69 |m[\verb||ad\_redi|
|00004bb0| 72 65 63 74 69 6f 6e 5c | 5f 68 69 73 74 6f 72 79 |rection\|_history|
|00004bc0| 7c 3a 5d 09 54 68 65 20 | 72 65 64 69 72 65 63 74 ||:].The |redirect|
|00004bd0| 69 6f 6e 20 68 69 73 74 | 6f 72 79 20 66 6f 72 0a |ion hist|ory for.|
|00004be0| 74 68 69 73 20 61 64 64 | 72 65 73 73 2e 0a 0a 5c |this add|ress...\|
|00004bf0| 69 74 65 6d 5b 5c 76 65 | 72 62 7c 61 64 5c 5f 6d |item[\ve|rb|ad\_m|
|00004c00| 65 73 73 61 67 65 5c 5f | 74 6f 6b 65 6e 7c 3a 5d |essage\_|token|:]|
|00004c10| 20 41 20 73 65 63 75 72 | 69 74 79 20 70 61 72 61 | A secur|ity para|
|00004c20| 6d 65 74 65 72 20 66 6f | 72 20 6d 65 73 73 61 67 |meter fo|r messag|
|00004c30| 65 20 74 6f 6b 65 6e 73 | 2e 0a 0a 5c 69 74 65 6d |e tokens|...\item|
|00004c40| 5b 5c 76 65 72 62 7c 61 | 64 5c 5f 63 6f 6e 74 65 |[\verb|a|d\_conte|
|00004c50| 6e 74 5c 5f 69 6e 74 65 | 67 72 69 74 79 7c 3a 5d |nt\_inte|grity|:]|
|00004c60| 09 41 20 63 6f 6e 74 65 | 6e 74 20 69 6e 74 65 67 |.A conte|nt integ|
|00004c70| 72 69 74 79 20 63 68 65 | 63 6b 20 70 61 72 61 6d |rity che|ck param|
|00004c80| 65 74 65 72 2e 0a 0a 5c | 69 74 65 6d 5b 5c 76 65 |eter...\|item[\ve|
|00004c90| 72 62 7c 61 64 5c 5f 70 | 72 6f 6f 66 5c 5f 64 65 |rb|ad\_p|roof\_de|
|00004ca0| 6c 76 65 72 79 7c 3a 5d | 09 50 72 6f 6f 66 20 6f |lvery|:]|.Proof o|
|00004cb0| 66 20 64 65 6c 69 76 65 | 72 79 20 69 73 20 72 65 |f delive|ry is re|
|00004cc0| 71 75 65 73 74 65 64 2e | 0a 0a 5c 69 74 65 6d 5b |quested.|..\item[|
|00004cd0| 5c 76 65 72 62 7c 61 64 | 5c 5f 72 65 73 70 20 7c |\verb|ad|\_resp ||
|00004ce0| 3a 5d 09 54 68 65 20 72 | 65 73 70 6f 6e 73 69 62 |:].The r|esponsib|
|00004cf0| 69 6c 69 74 79 20 62 69 | 74 2e 20 54 68 69 73 20 |ility bi|t. This |
|00004d00| 73 68 6f 75 6c 64 20 62 | 65 0a 73 65 74 20 74 6f |should b|e.set to|
|00004d10| 20 65 69 74 68 65 72 20 | 5c 76 65 72 62 7c 54 52 | either |\verb|TR|
|00004d20| 55 45 7c 20 6f 72 20 5c | 76 65 72 62 7c 46 41 4c |UE| or \|verb|FAL|
|00004d30| 53 45 7c 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 76 65 72 |SE|...\i|tem[\ver|
|00004d40| 62 7c 61 64 5c 5f 6d 74 | 61 72 65 71 7c 3a 5d 09 |b|ad\_mt|areq|:].|
|00004d50| 54 68 69 73 20 6d 61 70 | 73 20 74 6f 20 74 68 65 |This map|s to the|
|00004d60| 20 58 2e 34 30 30 20 4d | 54 41 20 0a 72 65 70 6f | X.400 M|TA .repo|
|00004d70| 72 74 20 72 65 71 75 65 | 73 74 20 62 69 74 73 2e |rt reque|st bits.|
|00004d80| 20 49 74 20 73 68 6f 75 | 6c 64 20 62 65 20 73 65 | It shou|ld be se|
|00004d90| 74 20 74 6f 20 6f 6e 65 | 20 6f 66 20 74 68 65 20 |t to one| of the |
|00004da0| 66 6f 6c 6c 6f 77 69 6e | 67 3a 0a 5c 5b 5c 62 65 |followin|g:.\[\be|
|00004db0| 67 69 6e 7b 74 61 62 75 | 6c 61 72 7d 7b 7c 6c 7c |gin{tabu|lar}{|l||
|00004dc0| 6c 7c 7d 0a 5c 68 6c 69 | 6e 65 0a 09 5c 6d 75 6c |l|}.\hli|ne..\mul|
|00004dd0| 74 69 63 6f 6c 75 6d 6e | 7b 31 7d 7b 7c 63 7c 7d |ticolumn|{1}{|c|}|
|00004de0| 7b 5c 62 66 20 56 61 6c | 75 65 7d 26 0a 09 09 5c |{\bf Val|ue}&...\|
|00004df0| 6d 75 6c 74 69 63 6f 6c | 75 6d 6e 7b 31 7d 7b 7c |multicol|umn{1}{||
|00004e00| 63 7c 7d 7b 5c 62 66 20 | 4d 65 61 6e 69 6e 67 7d |c|}{\bf |Meaning}|
|00004e10| 5c 5c 0a 5c 68 6c 69 6e | 65 0a 09 5c 74 74 20 41 |\\.\hlin|e..\tt A|
|00004e20| 44 5c 5f 4d 54 41 5c 5f | 4e 4f 4e 45 26 09 55 6e |D\_MTA\_|NONE&.Un|
|00004e30| 64 65 66 69 6e 65 64 20 | 76 61 6c 75 65 5c 5c 0a |defined |value\\.|
|00004e40| 09 5c 74 74 20 41 44 5c | 5f 4d 54 41 5c 5f 42 41 |.\tt AD\|_MTA\_BA|
|00004e50| 53 49 43 26 20 09 47 65 | 6e 65 72 61 74 65 20 44 |SIC& .Ge|nerate D|
|00004e60| 65 6c 69 76 65 72 79 20 | 66 61 69 6c 75 72 65 73 |elivery |failures|
|00004e70| 5c 5c 0a 09 5c 74 74 20 | 41 44 5c 5f 4d 54 41 5c |\\..\tt |AD\_MTA\|
|00004e80| 5f 43 4f 4e 46 49 52 4d | 26 09 47 65 6e 65 72 61 |_CONFIRM|&.Genera|
|00004e90| 74 65 20 44 65 6c 69 76 | 65 72 79 20 63 6f 6e 66 |te Deliv|ery conf|
|00004ea0| 69 72 6d 61 74 69 6f 6e | 73 5c 5c 0a 09 5c 74 74 |irmation|s\\..\tt|
|00004eb0| 20 41 44 5c 5f 4d 54 41 | 5c 5f 41 55 44 49 54 5c | AD\_MTA|\_AUDIT\|
|00004ec0| 5f 43 4f 4e 46 49 52 4d | 26 09 47 65 6e 65 72 61 |_CONFIRM|&.Genera|
|00004ed0| 74 65 20 66 75 6c 6c 20 | 74 72 61 63 65 20 63 6f |te full |trace co|
|00004ee0| 6e 66 69 72 6d 61 74 69 | 6f 6e 73 5c 5c 0a 5c 68 |nfirmati|ons\\.\h|
|00004ef0| 6c 69 6e 65 0a 5c 65 6e | 64 7b 74 61 62 75 6c 61 |line.\en|d{tabula|
|00004f00| 72 7d 5c 5d 0a 0a 5c 69 | 74 65 6d 5b 5c 76 65 72 |r}\]..\i|tem[\ver|
|00004f10| 62 7c 61 64 5c 5f 73 75 | 62 74 79 70 65 7c 3a 5d |b|ad\_su|btype|:]|
|00004f20| 09 54 68 65 20 73 75 62 | 74 79 70 65 20 6f 66 20 |.The sub|type of |
|00004f30| 74 68 65 20 61 64 64 72 | 65 73 73 20 69 66 0a 61 |the addr|ess if.a|
|00004f40| 70 70 72 6f 70 72 69 61 | 74 65 2e 20 54 68 69 73 |ppropria|te. This|
|00004f50| 20 69 73 20 6f 6e 6c 79 | 20 75 73 65 64 20 66 6f | is only| used fo|
|00004f60| 72 20 52 46 43 7e 38 32 | 32 20 61 64 64 72 65 73 |r RFC~82|2 addres|
|00004f70| 73 65 73 20 61 74 20 70 | 72 65 73 65 6e 74 2e 20 |ses at p|resent. |
|00004f80| 54 68 65 0a 76 61 6c 75 | 65 73 20 61 72 65 3a 0a |The.valu|es are:.|
|00004f90| 5c 5b 5c 62 65 67 69 6e | 7b 74 61 62 75 6c 61 72 |\[\begin|{tabular|
|00004fa0| 7d 7b 7c 6c 7c 6c 7c 7d | 0a 5c 68 6c 69 6e 65 0a |}{|l|l|}|.\hline.|
|00004fb0| 09 5c 6d 75 6c 74 69 63 | 6f 6c 75 6d 6e 7b 31 7d |.\multic|olumn{1}|
|00004fc0| 7b 7c 63 7c 7d 7b 5c 62 | 66 20 56 61 6c 75 65 7d |{|c|}{\b|f Value}|
|00004fd0| 26 0a 09 09 5c 6d 75 6c | 74 69 63 6f 6c 75 6d 6e |&...\mul|ticolumn|
|00004fe0| 7b 31 7d 7b 7c 63 7c 7d | 7b 5c 62 66 20 4d 65 61 |{1}{|c|}|{\bf Mea|
|00004ff0| 6e 69 6e 67 7d 5c 5c 0a | 5c 68 6c 69 6e 65 0a 09 |ning}\\.|\hline..|
|00005000| 5c 74 74 20 41 44 5c 5f | 4e 4f 53 55 42 54 59 50 |\tt AD\_|NOSUBTYP|
|00005010| 45 26 09 4e 6f 20 70 61 | 72 74 69 63 75 6c 61 72 |E&.No pa|rticular|
|00005020| 20 73 75 62 20 74 79 70 | 65 5c 5c 0a 09 5c 74 74 | sub typ|e\\..\tt|
|00005030| 20 41 44 5c 5f 4a 4e 54 | 26 09 09 4a 41 4e 45 54 | AD\_JNT|&..JANET|
|00005040| 20 73 74 79 6c 65 20 61 | 64 64 72 65 73 73 5c 5c | style a|ddress\\|
|00005050| 0a 09 5c 74 74 20 41 44 | 5c 5f 52 45 41 4c 37 33 |..\tt AD|\_REAL73|
|00005060| 33 26 09 52 46 43 7e 37 | 33 33 20 73 74 79 6c 65 |3&.RFC~7|33 style|
|00005070| 20 61 64 64 72 65 73 73 | 5c 5c 0a 09 5c 74 74 20 | address|\\..\tt |
|00005080| 41 44 5c 5f 52 45 41 4c | 38 32 32 26 09 52 46 43 |AD\_REAL|822&.RFC|
|00005090| 7e 38 32 32 20 73 74 79 | 6c 65 20 61 64 64 72 65 |~822 sty|le addre|
|000050a0| 73 73 5c 5c 0a 5c 68 6c | 69 6e 65 0a 5c 65 6e 64 |ss\\.\hl|ine.\end|
|000050b0| 7b 74 61 62 75 6c 61 72 | 7d 5c 5d 09 0a 0a 5c 69 |{tabular|}\]...\i|
|000050c0| 74 65 6d 5b 5c 76 65 72 | 62 7c 61 64 5c 5f 70 72 |tem[\ver|b|ad\_pr|
|000050d0| 65 5c 5f 72 65 63 69 70 | 5c 5f 65 78 74 5c 5f 6c |e\_recip|\_ext\_l|
|000050e0| 69 73 74 7c 3a 5d 09 41 | 20 6c 69 73 74 20 6f 66 |ist|:].A| list of|
|000050f0| 20 65 78 74 65 6e 73 69 | 6f 6e 0a 61 74 74 72 69 | extensi|on.attri|
|00005100| 62 75 74 65 73 2e 20 0a | 0a 5c 69 74 65 6d 5b 5c |butes. .|.\item[\|
|00005110| 76 65 72 62 7c 61 64 5c | 5f 76 61 6c 75 65 7c 3a |verb|ad\|_value|:|
|00005120| 5d 09 54 68 69 73 20 69 | 73 20 74 68 65 20 61 64 |].This i|s the ad|
|00005130| 64 72 65 73 73 20 73 75 | 62 6d 69 74 74 65 64 2e |dress su|bmitted.|
|00005140| 0a 0a 5c 69 74 65 6d 5b | 5c 76 65 72 62 7c 61 64 |..\item[|\verb|ad|
|00005150| 5c 5f 6e 65 78 74 7c 3a | 5d 09 54 68 65 20 6c 69 |\_next|:|].The li|
|00005160| 6e 6b 20 74 6f 20 74 68 | 65 20 6e 65 78 74 20 61 |nk to th|e next a|
|00005170| 64 64 72 65 73 73 20 69 | 66 20 74 68 65 79 20 61 |ddress i|f they a|
|00005180| 72 65 20 69 6e 20 61 0a | 6c 69 6e 6b 65 64 20 6c |re in a.|linked l|
|00005190| 69 73 74 2e 0a 5c 65 6e | 64 7b 64 65 73 63 72 69 |ist..\en|d{descri|
|000051a0| 62 65 7d 0a 0a 5c 73 75 | 62 73 65 63 74 69 6f 6e |be}..\su|bsection|
|000051b0| 7b 52 65 70 6c 79 20 56 | 61 6c 75 65 20 53 74 72 |{Reply V|alue Str|
|000051c0| 75 63 74 75 72 65 7d 0a | 0a 54 68 65 20 72 65 70 |ucture}.|.The rep|
|000051d0| 6c 79 20 76 61 6c 75 65 | 20 62 75 66 66 65 72 20 |ly value| buffer |
|000051e0| 73 74 72 75 63 74 75 72 | 65 20 69 73 20 73 68 6f |structur|e is sho|
|000051f0| 77 6e 20 69 6e 0a 46 69 | 67 75 72 65 7e 5c 72 65 |wn in.Fi|gure~\re|
|00005200| 66 7b 72 70 62 75 66 3a | 73 74 72 75 63 74 7d 2e |f{rpbuf:|struct}.|
|00005210| 20 54 68 69 73 20 69 73 | 20 75 73 65 64 20 69 6e | This is| used in|
|00005220| 20 61 6c 6c 20 68 61 6e | 64 73 68 61 6b 65 73 20 | all han|dshakes |
|00005230| 77 69 74 68 20 5c 70 67 | 6d 7b 73 75 62 6d 69 74 |with \pg|m{submit|
|00005240| 7d 0a 74 6f 20 72 65 74 | 75 72 6e 20 61 20 73 74 |}.to ret|urn a st|
|00005250| 61 74 75 73 20 61 6e 64 | 20 61 6e 20 65 78 70 6c |atus and| an expl|
|00005260| 61 6e 61 74 6f 72 79 20 | 73 74 72 69 6e 67 2e 0a |anatory |string..|
|00005270| 0a 5c 74 61 67 72 69 6e | 64 5b 68 62 70 5d 7b 72 |.\tagrin|d[hbp]{r|
|00005280| 70 62 73 74 72 75 63 74 | 7d 7b 52 65 70 6c 79 20 |pbstruct|}{Reply |
|00005290| 53 74 72 75 63 74 75 72 | 65 7d 7b 72 70 62 75 66 |Structur|e}{rpbuf|
|000052a0| 3a 73 74 72 75 63 74 7d | 0a 0a 54 68 65 20 73 74 |:struct}|..The st|
|000052b0| 72 75 63 74 75 72 65 20 | 68 65 72 65 20 69 73 3a |ructure |here is:|
|000052c0| 0a 0a 5c 62 65 67 69 6e | 7b 64 65 73 63 72 69 62 |..\begin|{describ|
|000052d0| 65 7d 5c 69 6e 64 65 78 | 7b 52 65 70 6c 79 20 73 |e}\index|{Reply s|
|000052e0| 74 72 75 63 74 75 72 65 | 7d 5c 69 6e 64 65 78 7b |tructure|}\index{|
|000052f0| 52 50 5c 5f 42 75 66 7d | 0a 5c 69 74 65 6d 5b 5c |RP\_Buf}|.\item[\|
|00005300| 76 65 72 62 7c 72 70 5c | 5f 76 61 6c 7c 3a 5d 09 |verb|rp\|_val|:].|
|00005310| 54 68 65 20 76 61 6c 75 | 65 20 72 65 74 75 72 6e |The valu|e return|
|00005320| 65 64 3b 20 74 68 69 73 | 20 69 73 20 6f 6e 65 20 |ed; this| is one |
|00005330| 6f 66 20 74 68 6f 73 65 | 0a 64 65 66 69 6e 65 64 |of those|.defined|
|00005340| 20 69 6e 20 5c 66 69 6c | 65 7b 72 65 74 63 6f 64 | in \fil|e{retcod|
|00005350| 65 2e 68 7d 2e 0a 0a 5c | 69 74 65 6d 5b 5c 76 65 |e.h}...\|item[\ve|
|00005360| 72 62 7c 72 70 5c 5f 6c | 69 6e 65 7c 3a 5d 09 41 |rb|rp\_l|ine|:].A|
|00005370| 6e 20 6f 70 74 69 6f 6e | 61 6c 20 65 78 70 6c 61 |n option|al expla|
|00005380| 6e 61 74 6f 72 79 20 73 | 74 72 69 6e 67 2e 0a 5c |natory s|tring..\|
|00005390| 65 6e 64 7b 64 65 73 63 | 72 69 62 65 7d 0a 0a 5c |end{desc|ribe}..\|
|000053a0| 73 75 62 73 65 63 74 69 | 6f 6e 20 7b 50 72 6f 63 |subsecti|on {Proc|
|000053b0| 65 64 75 72 65 20 43 61 | 6c 6c 73 7d 0a 0a 54 68 |edure Ca|lls}..Th|
|000053c0| 65 20 73 75 62 6d 69 73 | 73 69 6f 6e 20 69 6e 74 |e submis|sion int|
|000053d0| 65 72 66 61 63 65 20 69 | 73 20 70 72 6f 63 65 64 |erface i|s proced|
|000053e0| 75 72 61 6c 20 61 6e 64 | 20 68 61 73 20 61 20 68 |ural and| has a h|
|000053f0| 61 6e 64 73 68 61 6b 65 | 20 61 74 20 6d 6f 73 74 |andshake| at most|
|00005400| 20 6f 66 0a 74 68 65 20 | 69 6e 74 65 72 61 63 74 | of.the |interact|
|00005410| 69 6f 6e 20 70 6f 69 6e | 74 73 2e 20 54 68 69 73 |ion poin|ts. This|
|00005420| 20 69 6e 74 65 72 61 63 | 74 69 6f 6e 20 69 73 20 | interac|tion is |
|00005430| 72 65 61 73 6f 6e 61 62 | 6c 79 20 63 6f 6d 70 6c |reasonab|ly compl|
|00005440| 65 78 20 62 75 74 0a 61 | 6c 6c 6f 77 73 20 74 68 |ex but.a|llows th|
|00005450| 65 20 73 75 62 6d 69 73 | 73 69 6f 6e 20 74 6f 20 |e submis|sion to |
|00005460| 62 65 20 66 6c 65 78 69 | 62 6c 65 3b 20 74 68 69 |be flexi|ble; thi|
|00005470| 73 20 69 6e 74 65 72 66 | 61 63 65 20 63 61 6e 20 |s interf|ace can |
|00005480| 62 65 20 75 73 65 64 20 | 74 6f 0a 76 61 6c 69 64 |be used |to.valid|
|00005490| 61 74 65 20 61 64 64 72 | 65 73 73 20 61 73 20 77 |ate addr|ess as w|
|000054a0| 65 6c 6c 20 61 73 20 74 | 6f 20 73 75 62 6d 69 74 |ell as t|o submit|
|000054b0| 20 6d 65 73 73 61 67 65 | 2e 0a 0a 4d 6f 73 74 20 | message|...Most |
|000054c0| 6f 66 20 74 68 65 73 65 | 20 72 6f 75 74 69 6e 65 |of these| routine|
|000054d0| 73 20 72 65 74 75 72 6e | 20 61 20 73 65 74 20 6f |s return| a set o|
|000054e0| 66 20 63 6f 64 65 73 20 | 61 73 20 64 65 66 69 6e |f codes |as defin|
|000054f0| 65 64 20 69 6e 0a 5c 66 | 69 6c 65 7b 72 65 74 63 |ed in.\f|ile{retc|
|00005500| 6f 64 65 2e 68 7d 20 74 | 6f 20 69 6e 64 69 63 61 |ode.h} t|o indica|
|00005510| 74 65 20 73 75 63 63 65 | 73 73 20 6f 72 20 66 61 |te succe|ss or fa|
|00005520| 69 6c 75 72 65 20 6f 66 | 20 74 68 65 20 6f 70 65 |ilure of| the ope|
|00005530| 72 61 74 69 6f 6e 2e 20 | 54 68 65 0a 63 6f 64 65 |ration. |The.code|
|00005540| 73 20 69 6e 64 69 63 61 | 74 65 20 64 65 74 61 69 |s indica|te detai|
|00005550| 6c 65 64 20 73 74 61 74 | 75 73 20 61 6e 64 20 61 |led stat|us and a|
|00005560| 72 65 20 73 68 6f 77 6e | 20 69 6e 0a 54 61 62 6c |re shown| in.Tabl|
|00005570| 65 7e 5c 72 65 66 7b 74 | 61 62 3a 72 70 63 6f 64 |e~\ref{t|ab:rpcod|
|00005580| 65 73 7d 2e 20 54 77 6f | 20 6d 61 63 72 6f 73 20 |es}. Two| macros |
|00005590| 61 72 65 20 75 73 65 66 | 75 6c 20 66 6f 72 20 64 |are usef|ul for d|
|000055a0| 65 74 65 72 6d 69 6e 69 | 6e 67 20 74 68 65 0a 67 |etermini|ng the.g|
|000055b0| 65 6e 65 72 61 6c 20 73 | 74 61 74 75 73 20 6f 66 |eneral s|tatus of|
|000055c0| 20 74 68 65 20 72 65 70 | 6c 79 2e 20 54 68 65 20 | the rep|ly. The |
|000055d0| 62 65 68 61 76 65 20 61 | 73 20 74 68 6f 75 67 68 |behave a|s though|
|000055e0| 20 74 68 65 79 20 77 65 | 72 65 20 64 65 66 69 6e | they we|re defin|
|000055f0| 65 64 20 61 73 3a 0a 5c | 62 65 67 69 6e 7b 71 75 |ed as:.\|begin{qu|
|00005600| 6f 74 65 7d 5c 69 6e 64 | 65 78 7b 72 70 5c 5f 69 |ote}\ind|ex{rp\_i|
|00005610| 73 67 6f 6f 64 7d 5c 69 | 6e 64 65 78 7b 72 70 5c |sgood}\i|ndex{rp\|
|00005620| 5f 69 73 62 61 64 7d 5c | 62 65 67 69 6e 7b 76 65 |_isbad}\|begin{ve|
|00005630| 72 62 61 74 69 6d 7d 0a | 69 6e 74 20 72 70 5f 69 |rbatim}.|int rp_i|
|00005640| 73 67 6f 6f 64 20 28 63 | 6f 64 65 29 0a 69 6e 74 |sgood (c|ode).int|
|00005650| 20 63 6f 64 65 3b 0a 0a | 69 6e 74 20 72 70 5f 69 | code;..|int rp_i|
|00005660| 73 62 61 64 20 28 63 6f | 64 65 29 0a 69 6e 74 20 |sbad (co|de).int |
|00005670| 63 6f 64 65 3b 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |code;.\e|nd{verba|
|00005680| 74 69 6d 7d 5c 65 6e 64 | 7b 71 75 6f 74 65 7d 0a |tim}\end|{quote}.|
|00005690| 77 68 65 72 65 20 60 60 | 63 6f 64 65 27 27 20 69 |where ``|code'' i|
|000056a0| 73 20 74 68 65 20 72 65 | 74 75 72 6e 20 63 6f 64 |s the re|turn cod|
|000056b0| 65 2e 20 54 68 65 20 6d | 61 63 72 6f 73 20 72 65 |e. The m|acros re|
|000056c0| 74 75 72 6e 20 62 6f 6f | 6c 65 61 6e 20 76 61 6c |turn boo|lean val|
|000056d0| 75 65 73 20 6f 66 0a 5c | 76 65 72 62 7c 54 52 55 |ues of.\|verb|TRU|
|000056e0| 45 7c 20 69 66 20 74 68 | 65 20 63 6f 64 65 20 69 |E| if th|e code i|
|000056f0| 73 20 67 65 6e 65 72 61 | 6c 6c 79 20 67 6f 6f 64 |s genera|lly good|
|00005700| 20 6f 72 20 62 61 64 20 | 72 65 73 70 65 63 74 69 | or bad |respecti|
|00005710| 76 65 6c 79 2e 0a 0a 5c | 74 61 67 74 61 62 6c 65 |vely...\|tagtable|
|00005720| 5b 68 62 74 70 5d 7b 72 | 70 63 6f 64 65 73 7d 7b |[hbtp]{r|pcodes}{|
|00005730| 52 65 74 75 72 6e 20 43 | 6f 64 65 73 7d 7b 74 61 |Return C|odes}{ta|
|00005740| 62 3a 72 70 63 6f 64 65 | 73 7d 0a 0a 41 6c 6f 6e |b:rpcode|s}..Alon|
|00005750| 67 20 77 69 74 68 20 6f | 74 68 65 72 20 70 61 72 |g with o|ther par|
|00005760| 61 6d 65 74 65 72 73 2c | 20 74 68 65 73 65 20 72 |ameters,| these r|
|00005770| 6f 75 74 69 6e 65 73 20 | 75 73 75 61 6c 6c 79 20 |outines |usually |
|00005780| 74 61 6b 65 20 61 6e 0a | 5c 76 65 72 62 7c 52 50 |take an.|\verb|RP|
|00005790| 5f 42 75 66 7c 5c 69 6e | 64 65 78 7b 52 50 5c 5f |_Buf|\in|dex{RP\_|
|000057a0| 42 75 66 7d 20 73 74 72 | 75 63 74 75 72 65 20 77 |Buf} str|ucture w|
|000057b0| 68 69 63 68 20 69 73 20 | 75 70 64 61 74 65 64 20 |hich is |updated |
|000057c0| 77 69 74 68 20 74 68 65 | 20 63 6f 64 65 0a 61 6e |with the| code.an|
|000057d0| 64 20 61 6e 20 65 78 70 | 6c 61 6e 61 74 6f 72 79 |d an exp|lanatory|
|000057e0| 20 73 74 72 69 6e 67 20 | 69 66 20 74 68 65 20 72 | string |if the r|
|000057f0| 6f 75 74 69 6e 65 20 66 | 61 69 6c 73 20 69 6e 20 |outine f|ails in |
|00005800| 73 6f 6d 65 20 77 61 79 | 2e 0a 0a 5c 73 75 62 73 |some way|...\subs|
|00005810| 75 62 73 65 63 74 69 6f | 6e 7b 49 6e 69 74 69 61 |ubsectio|n{Initia|
|00005820| 6c 69 73 61 74 69 6f 6e | 7d 0a 0a 54 6f 20 69 6e |lisation|}..To in|
|00005830| 69 74 69 61 6c 69 73 65 | 20 74 68 65 20 73 75 62 |itialise| the sub|
|00005840| 6d 69 73 73 69 6f 6e 20 | 73 79 73 74 65 6d 20 69 |mission |system i|
|00005850| 74 20 69 73 20 66 69 72 | 73 74 20 6e 65 63 65 73 |t is fir|st neces|
|00005860| 73 61 72 79 20 74 6f 20 | 63 61 6c 6c 20 74 68 65 |sary to |call the|
|00005870| 0a 72 6f 75 74 69 6e 65 | 20 5c 76 65 72 62 7c 69 |.routine| \verb|i|
|00005880| 6f 5f 69 6e 69 74 7c 3a | 0a 5c 62 65 67 69 6e 7b |o_init|:|.\begin{|
|00005890| 71 75 6f 74 65 7d 5c 69 | 6e 64 65 78 7b 69 6f 5c |quote}\i|ndex{io\|
|000058a0| 5f 69 6e 69 74 7d 5c 62 | 65 67 69 6e 7b 76 65 72 |_init}\b|egin{ver|
|000058b0| 62 61 74 69 6d 7d 0a 69 | 6e 74 20 69 6f 5f 69 6e |batim}.i|nt io_in|
|000058c0| 69 74 20 28 72 70 29 0a | 52 50 5f 42 75 66 20 2a |it (rp).|RP_Buf *|
|000058d0| 72 70 3b 0a 5c 65 6e 64 | 7b 76 65 72 62 61 74 69 |rp;.\end|{verbati|
|000058e0| 6d 7d 5c 65 6e 64 7b 71 | 75 6f 74 65 7d 0a 54 68 |m}\end{q|uote}.Th|
|000058f0| 69 73 20 63 61 6c 6c 20 | 69 6e 69 74 69 61 6c 69 |is call |initiali|
|00005900| 73 65 73 20 74 68 65 20 | 73 75 62 6d 69 73 73 69 |ses the |submissi|
|00005910| 6f 6e 20 62 79 20 65 69 | 74 68 65 72 20 69 6e 76 |on by ei|ther inv|
|00005920| 6f 6b 69 6e 67 20 5c 70 | 67 6d 7b 73 75 62 6d 69 |oking \p|gm{submi|
|00005930| 74 7d 0a 61 73 20 61 20 | 63 68 69 6c 64 20 70 72 |t}.as a |child pr|
|00005940| 6f 63 65 73 73 20 6f 72 | 20 62 79 20 63 6f 6e 6e |ocess or| by conn|
|00005950| 65 63 74 69 6e 67 20 74 | 6f 20 61 20 5c 70 67 6d |ecting t|o a \pgm|
|00005960| 7b 73 75 62 6d 69 74 7d | 20 64 61 65 6d 6f 6e 2e |{submit}| daemon.|
|00005970| 20 49 74 0a 72 65 74 75 | 72 6e 73 20 61 20 67 6f | It.retu|rns a go|
|00005980| 6f 64 20 6f 72 20 62 61 | 64 20 73 74 61 74 75 73 |od or ba|d status|
|00005990| 2c 20 61 6e 64 20 66 69 | 6c 6c 73 20 69 6e 20 74 |, and fi|lls in t|
|000059a0| 68 65 20 5c 76 65 72 62 | 7c 72 70 7c 20 73 74 72 |he \verb||rp| str|
|000059b0| 75 63 74 75 72 65 20 69 | 66 0a 74 68 65 20 72 65 |ucture i|f.the re|
|000059c0| 73 70 6f 6e 73 65 20 69 | 73 20 62 61 64 2e 0a 0a |sponse i|s bad...|
|000059d0| 5c 73 75 62 73 75 62 73 | 65 63 74 69 6f 6e 7b 4d |\subsubs|ection{M|
|000059e0| 65 73 73 61 67 65 20 4d | 61 6e 61 67 65 6d 65 6e |essage M|anagemen|
|000059f0| 74 20 50 61 72 61 6d 65 | 74 65 72 73 7d 0a 0a 54 |t Parame|ters}..T|
|00005a00| 68 65 20 66 69 72 73 74 | 20 73 65 74 20 6f 66 20 |he first| set of |
|00005a10| 70 61 72 61 6d 65 74 65 | 72 73 20 74 6f 20 6e 65 |paramete|rs to ne|
|00005a20| 67 6f 74 69 61 74 65 20 | 77 69 74 68 20 5c 70 67 |gotiate |with \pg|
|00005a30| 6d 7b 73 75 62 6d 69 74 | 7d 20 61 72 65 20 74 68 |m{submit|} are th|
|00005a40| 65 0a 6d 61 6e 61 67 65 | 6d 65 6e 74 20 70 61 72 |e.manage|ment par|
|00005a50| 61 6d 65 74 65 72 73 2e | 20 54 68 65 73 65 20 61 |ameters.| These a|
|00005a60| 72 65 20 64 65 66 69 6e | 65 64 20 69 6e 20 74 68 |re defin|ed in th|
|00005a70| 65 20 73 74 72 75 63 74 | 75 72 65 20 69 6e 0a 46 |e struct|ure in.F|
|00005a80| 69 67 75 72 65 7e 5c 72 | 65 66 7b 70 72 6d 3a 73 |igure~\r|ef{prm:s|
|00005a90| 74 72 75 63 74 7d 20 6f | 6e 20 70 61 67 65 7e 5c |truct} o|n page~\|
|00005aa0| 70 61 67 65 72 65 66 7b | 70 72 6d 3a 73 74 72 75 |pageref{|prm:stru|
|00005ab0| 63 74 7d 2e 20 54 68 69 | 73 20 73 74 72 75 63 74 |ct}. Thi|s struct|
|00005ac0| 75 72 65 0a 69 73 20 70 | 61 73 73 65 64 20 6f 76 |ure.is p|assed ov|
|00005ad0| 65 72 20 75 73 69 6e 67 | 20 74 68 65 20 5c 76 65 |er using| the \ve|
|00005ae0| 72 62 7c 69 6f 5f 77 70 | 72 6d 7c 20 72 6f 75 74 |rb|io_wp|rm| rout|
|00005af0| 69 6e 65 3a 0a 5c 62 65 | 67 69 6e 7b 71 75 6f 74 |ine:.\be|gin{quot|
|00005b00| 65 7d 5c 69 6e 64 65 78 | 7b 69 6f 5c 5f 77 70 72 |e}\index|{io\_wpr|
|00005b10| 6d 7d 5c 62 65 67 69 6e | 7b 76 65 72 62 61 74 69 |m}\begin|{verbati|
|00005b20| 6d 7d 0a 69 6e 74 20 69 | 6f 5f 77 70 72 6d 20 28 |m}.int i|o_wprm (|
|00005b30| 70 72 6d 2c 20 72 70 29 | 0a 73 74 72 75 63 74 20 |prm, rp)|.struct |
|00005b40| 70 72 6d 5f 76 61 72 73 | 20 2a 70 72 6d 3b 0a 52 |prm_vars| *prm;.R|
|00005b50| 50 5f 42 75 66 20 2a 72 | 70 3b 0a 5c 65 6e 64 7b |P_Buf *r|p;.\end{|
|00005b60| 76 65 72 62 61 74 69 6d | 7d 5c 65 6e 64 7b 71 75 |verbatim|}\end{qu|
|00005b70| 6f 74 65 7d 0a 54 68 65 | 20 70 61 72 61 6d 65 74 |ote}.The| paramet|
|00005b80| 65 72 20 73 74 72 75 63 | 74 75 72 65 20 69 73 20 |er struc|ture is |
|00005b90| 6f 66 74 65 6e 20 6f 6e | 6c 79 20 73 70 61 72 73 |often on|ly spars|
|00005ba0| 65 6c 79 20 66 69 6c 6c | 65 64 20 28 6f 72 20 65 |ely fill|ed (or e|
|00005bb0| 76 65 6e 20 65 6d 70 74 | 79 29 2c 0a 61 73 20 74 |ven empt|y),.as t|
|00005bc0| 68 65 20 64 65 66 61 75 | 6c 74 20 76 61 6c 75 65 |he defau|lt value|
|00005bd0| 73 20 61 73 73 75 6d 65 | 64 20 61 72 65 20 75 73 |s assume|d are us|
|00005be0| 75 61 6c 6c 79 20 63 6f | 72 72 65 63 74 20 66 6f |ually co|rrect fo|
|00005bf0| 72 20 6d 6f 73 74 20 63 | 6f 6d 6d 6f 6e 0a 73 75 |r most c|ommon.su|
|00005c00| 62 6d 69 73 73 69 6f 6e | 73 2e 0a 0a 5c 73 75 62 |bmission|s...\sub|
|00005c10| 73 75 62 73 65 63 74 69 | 6f 6e 7b 50 65 72 2d 4d |subsecti|on{Per-M|
|00005c20| 65 73 73 61 67 65 20 50 | 61 72 61 6d 65 74 65 72 |essage P|arameter|
|00005c30| 73 7d 0a 0a 54 68 65 20 | 6e 65 78 74 20 73 74 61 |s}..The |next sta|
|00005c40| 67 65 20 69 73 20 74 68 | 65 20 70 65 72 2d 6d 65 |ge is th|e per-me|
|00005c50| 73 73 61 67 65 20 70 61 | 72 61 6d 65 74 65 72 73 |ssage pa|rameters|
|00005c60| 2e 20 54 68 69 73 20 69 | 73 20 61 63 68 69 65 76 |. This i|s achiev|
|00005c70| 65 64 20 62 79 0a 66 69 | 6c 6c 69 6e 67 20 69 6e |ed by.fi|lling in|
|00005c80| 20 61 20 5c 76 65 72 62 | 7c 51 5f 73 74 72 75 63 | a \verb||Q_struc|
|00005c90| 74 7c 5c 69 6e 64 65 78 | 7b 51 5c 5f 73 74 72 75 |t|\index|{Q\_stru|
|00005ca0| 63 74 7d 20 73 74 72 75 | 63 74 75 72 65 20 61 6e |ct} stru|cture an|
|00005cb0| 64 20 70 61 73 73 69 6e | 67 20 69 74 0a 74 6f 20 |d passin|g it.to |
|00005cc0| 5c 70 67 6d 7b 73 75 62 | 6d 69 74 7d 2e 0a 4f 6e |\pgm{sub|mit}..On|
|00005cd0| 63 65 20 74 68 65 20 73 | 74 72 75 63 74 75 72 65 |ce the s|tructure|
|00005ce0| 20 69 73 20 63 6f 6d 70 | 6c 65 74 65 20 69 74 20 | is comp|lete it |
|00005cf0| 63 61 6e 20 62 65 20 77 | 72 69 74 74 65 6e 20 74 |can be w|ritten t|
|00005d00| 6f 20 5c 70 67 6d 7b 73 | 75 62 6d 69 74 7d 20 75 |o \pgm{s|ubmit} u|
|00005d10| 73 69 6e 67 20 74 68 65 | 0a 5c 76 65 72 62 7c 69 |sing the|.\verb|i|
|00005d20| 6f 5f 77 72 71 7c 20 72 | 6f 75 74 69 6e 65 3a 0a |o_wrq| r|outine:.|
|00005d30| 5c 62 65 67 69 6e 7b 71 | 75 6f 74 65 7d 5c 69 6e |\begin{q|uote}\in|
|00005d40| 64 65 78 7b 69 6f 5c 5f | 77 72 71 7d 5c 62 65 67 |dex{io\_|wrq}\beg|
|00005d50| 69 6e 7b 76 65 72 62 61 | 74 69 6d 7d 0a 69 6f 5f |in{verba|tim}.io_|
|00005d60| 77 72 71 20 28 71 70 2c | 20 72 70 29 0a 51 5f 73 |wrq (qp,| rp).Q_s|
|00005d70| 74 72 75 63 74 20 2a 71 | 70 3b 0a 52 50 5f 42 75 |truct *q|p;.RP_Bu|
|00005d80| 66 20 2a 72 70 3b 0a 5c | 65 6e 64 7b 76 65 72 62 |f *rp;.\|end{verb|
|00005d90| 61 74 69 6d 7d 5c 65 6e | 64 7b 71 75 6f 74 65 7d |atim}\en|d{quote}|
|00005da0| 0a 0a 0a 5c 73 75 62 73 | 75 62 73 65 63 74 69 6f |...\subs|ubsectio|
|00005db0| 6e 7b 4f 72 69 67 69 6e | 61 74 6f 72 20 61 6e 64 |n{Origin|ator and|
|00005dc0| 20 52 65 63 69 70 69 65 | 6e 74 20 41 64 64 72 65 | Recipie|nt Addre|
|00005dd0| 73 73 65 73 7d 0a 0a 41 | 66 74 65 72 20 74 68 65 |sses}..A|fter the|
|00005de0| 20 67 65 6e 65 72 61 6c | 20 70 61 72 61 6d 65 74 | general| paramet|
|00005df0| 65 72 73 20 68 61 76 65 | 20 62 65 65 6e 20 70 61 |ers have| been pa|
|00005e00| 73 73 65 64 20 62 79 20 | 74 68 65 20 61 62 6f 76 |ssed by |the abov|
|00005e10| 65 20 72 6f 75 74 69 6e | 65 73 2c 0a 74 68 65 20 |e routin|es,.the |
|00005e20| 73 65 6e 64 20 69 73 20 | 70 61 73 73 65 64 20 6f |send is |passed o|
|00005e30| 76 65 72 20 69 6e 20 74 | 68 65 20 73 74 61 6e 64 |ver in t|he stand|
|00005e40| 61 72 64 69 73 65 64 20 | 61 64 64 72 65 73 73 20 |ardised |address |
|00005e50| 73 74 72 75 63 74 75 72 | 65 2e 0a 54 68 65 20 63 |structur|e..The c|
|00005e60| 61 6c 6c 20 74 6f 20 61 | 63 68 69 65 76 65 20 74 |all to a|chieve t|
|00005e70| 68 69 73 20 69 73 20 74 | 68 65 20 5c 76 65 72 62 |his is t|he \verb|
|00005e80| 7c 77 72 5f 61 64 72 7c | 20 72 6f 75 74 69 6e 65 ||wr_adr|| routine|
|00005e90| 3a 0a 5c 62 65 67 69 6e | 7b 71 75 6f 74 65 7d 5c |:.\begin|{quote}\|
|00005ea0| 69 6e 64 65 78 7b 69 6f | 5c 5f 77 61 64 72 7d 5c |index{io|\_wadr}\|
|00005eb0| 62 65 67 69 6e 7b 76 65 | 72 62 61 74 69 6d 7d 0a |begin{ve|rbatim}.|
|00005ec0| 69 6e 74 20 69 6f 5f 77 | 61 64 72 20 28 61 70 2c |int io_w|adr (ap,|
|00005ed0| 20 74 79 70 65 2c 20 72 | 70 29 0a 41 44 44 52 20 | type, r|p).ADDR |
|00005ee0| 2a 61 64 64 72 3b 0a 69 | 6e 74 20 20 74 79 70 65 |*addr;.i|nt type|
|00005ef0| 3b 0a 52 50 5f 42 75 66 | 20 2a 72 70 3b 0a 5c 65 |;.RP_Buf| *rp;.\e|
|00005f00| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 5c 65 6e 64 |nd{verba|tim}\end|
|00005f10| 7b 71 75 6f 74 65 7d 0a | 54 68 65 20 74 79 70 65 |{quote}.|The type|
|00005f20| 20 70 61 72 61 6d 65 74 | 65 72 20 69 73 20 65 69 | paramet|er is ei|
|00005f30| 74 68 65 72 20 5c 76 65 | 72 62 7c 41 44 5f 4f 52 |ther \ve|rb|AD_OR|
|00005f40| 49 47 49 4e 41 54 4f 52 | 7c 20 6f 72 0a 5c 76 65 |IGINATOR|| or.\ve|
|00005f50| 72 62 7c 41 44 5f 52 45 | 43 49 50 49 45 4e 54 7c |rb|AD_RE|CIPIENT||
|00005f60| 2e 20 20 46 69 72 73 74 | 20 74 68 65 20 6f 72 69 |. First| the ori|
|00005f70| 67 69 6e 61 74 6f 72 20 | 61 64 64 72 65 73 73 20 |ginator |address |
|00005f80| 69 73 20 70 61 73 73 65 | 64 20 6f 76 65 72 20 61 |is passe|d over a|
|00005f90| 6e 64 0a 63 68 65 63 6b | 65 64 20 66 6f 6c 6c 6f |nd.check|ed follo|
|00005fa0| 77 65 64 20 62 79 20 74 | 68 65 20 6c 69 73 74 20 |wed by t|he list |
|00005fb0| 6f 66 20 72 65 63 69 70 | 69 65 6e 74 73 2e 20 54 |of recip|ients. T|
|00005fc0| 68 69 73 20 69 73 20 74 | 68 65 6e 20 66 6f 6c 6c |his is t|hen foll|
|00005fd0| 6f 77 65 64 20 62 79 0a | 65 61 63 68 20 6f 66 20 |owed by.|each of |
|00005fe0| 74 68 65 20 72 65 63 69 | 70 69 65 6e 74 20 61 64 |the reci|pient ad|
|00005ff0| 64 72 65 73 73 65 73 2e | 20 20 49 6e 20 74 68 69 |dresses.| In thi|
|00006000| 73 20 77 61 79 2c 20 65 | 61 63 68 20 61 64 64 72 |s way, e|ach addr|
|00006010| 65 73 73 20 69 73 20 63 | 68 65 63 6b 65 64 0a 61 |ess is c|hecked.a|
|00006020| 6e 64 20 61 6e 79 20 66 | 61 69 6c 75 72 65 73 20 |nd any f|ailures |
|00006030| 63 61 6e 20 62 65 20 70 | 69 6e 70 6f 69 6e 74 65 |can be p|inpointe|
|00006040| 64 2e 20 0a 0a 57 68 65 | 6e 20 61 6c 6c 20 74 68 |d. ..Whe|n all th|
|00006050| 65 20 61 64 64 72 65 73 | 73 65 73 20 68 61 76 65 |e addres|ses have|
|00006060| 20 62 65 65 6e 20 73 75 | 62 6d 69 74 74 65 64 2c | been su|bmitted,|
|00006070| 20 74 68 65 20 61 64 64 | 72 65 73 73 20 6c 69 73 | the add|ress lis|
|00006080| 74 20 69 73 0a 74 65 72 | 6d 69 6e 61 74 65 64 20 |t is.ter|minated |
|00006090| 77 69 74 68 20 74 68 65 | 20 63 61 6c 6c 3a 0a 5c |with the| call:.\|
|000060a0| 62 65 67 69 6e 7b 71 75 | 6f 74 65 7d 5c 69 6e 64 |begin{qu|ote}\ind|
|000060b0| 65 78 7b 69 6f 5c 5f 61 | 64 65 6e 64 7d 5c 62 65 |ex{io\_a|dend}\be|
|000060c0| 67 69 6e 7b 76 65 72 62 | 61 74 69 6d 7d 0a 69 6e |gin{verb|atim}.in|
|000060d0| 74 20 69 6f 5f 61 64 65 | 6e 64 20 28 72 70 29 0a |t io_ade|nd (rp).|
|000060e0| 52 50 5f 42 75 66 20 2a | 72 70 3b 0a 5c 65 6e 64 |RP_Buf *|rp;.\end|
|000060f0| 7b 76 65 72 62 61 74 69 | 6d 7d 5c 65 6e 64 7b 71 |{verbati|m}\end{q|
|00006100| 75 6f 74 65 7d 0a 54 68 | 69 73 20 63 6f 6e 63 6c |uote}.Th|is concl|
|00006110| 75 64 65 73 20 74 68 65 | 20 70 72 65 6c 69 6d 69 |udes the| prelimi|
|00006120| 6e 61 72 69 65 73 2c 20 | 61 6e 64 20 74 68 65 20 |naries, |and the |
|00006130| 62 6f 64 79 20 6f 66 20 | 74 68 65 20 6d 65 73 73 |body of |the mess|
|00006140| 61 67 65 20 63 61 6e 20 | 62 65 0a 74 72 61 6e 73 |age can |be.trans|
|00006150| 66 65 72 72 65 64 2e 0a | 0a 5c 73 75 62 73 75 62 |ferred..|.\subsub|
|00006160| 73 65 63 74 69 6f 6e 7b | 42 6f 64 79 20 50 61 72 |section{|Body Par|
|00006170| 74 20 53 75 62 6d 69 73 | 73 69 6f 6e 7d 0a 0a 54 |t Submis|sion}..T|
|00006180| 68 65 20 62 6f 64 79 20 | 70 61 72 74 73 20 70 72 |he body |parts pr|
|00006190| 65 73 65 6e 74 65 64 20 | 61 72 65 20 64 65 70 65 |esented |are depe|
|000061a0| 6e 64 65 6e 74 20 6f 6e | 20 74 68 65 20 74 79 70 |ndent on| the typ|
|000061b0| 65 20 6f 66 20 6d 65 73 | 73 61 67 65 20 62 65 69 |e of mes|sage bei|
|000061c0| 6e 67 0a 74 72 61 6e 73 | 66 65 72 72 65 64 2e 20 |ng.trans|ferred. |
|000061d0| 20 54 6f 20 69 6e 69 74 | 69 61 6c 69 73 65 20 66 | To init|ialise f|
|000061e0| 6f 72 20 62 6f 64 79 20 | 70 61 72 74 20 73 75 62 |or body |part sub|
|000061f0| 6d 69 73 73 69 6f 6e 2c | 20 74 68 65 20 66 6f 6c |mission,| the fol|
|00006200| 6c 6f 77 69 6e 67 0a 66 | 75 6e 63 74 69 6f 6e 20 |lowing.f|unction |
|00006210| 69 73 20 63 61 6c 6c 65 | 64 3a 0a 5c 62 65 67 69 |is calle|d:.\begi|
|00006220| 6e 7b 71 75 6f 74 65 7d | 5c 69 6e 64 65 78 7b 69 |n{quote}|\index{i|
|00006230| 6f 5c 5f 74 69 6e 69 74 | 7d 5c 62 65 67 69 6e 7b |o\_tinit|}\begin{|
|00006240| 76 65 72 62 61 74 69 6d | 7d 0a 69 6f 5f 74 69 6e |verbatim|}.io_tin|
|00006250| 69 74 20 28 72 70 29 0a | 52 50 5f 42 75 66 20 2a |it (rp).|RP_Buf *|
|00006260| 72 70 3b 0a 5c 65 6e 64 | 7b 76 65 72 62 61 74 69 |rp;.\end|{verbati|
|00006270| 6d 7d 5c 65 6e 64 7b 71 | 75 6f 74 65 7d 0a 54 68 |m}\end{q|uote}.Th|
|00006280| 69 73 20 69 6e 69 74 69 | 61 6c 69 73 65 73 20 66 |is initi|alises f|
|00006290| 6f 72 20 74 65 78 74 20 | 73 75 62 6d 69 73 73 69 |or text |submissi|
|000062a0| 6f 6e 2e 0a 0a 46 6f 6c | 6c 6f 77 69 6e 67 20 74 |on...Fol|lowing t|
|000062b0| 68 69 73 20 63 61 6c 6c | 20 69 74 20 69 73 20 6e |his call| it is n|
|000062c0| 65 63 65 73 73 61 72 79 | 20 74 6f 20 69 6e 69 74 |ecessary| to init|
|000062d0| 69 61 6c 69 73 65 20 66 | 6f 72 20 74 68 65 20 66 |ialise f|or the f|
|000062e0| 69 72 73 74 20 62 6f 64 | 79 0a 70 61 72 74 2e 20 |irst bod|y.part. |
|000062f0| 20 54 68 69 73 20 69 73 | 20 64 6f 6e 65 20 62 79 | This is| done by|
|00006300| 3a 0a 5c 62 65 67 69 6e | 7b 71 75 6f 74 65 7d 5c |:.\begin|{quote}\|
|00006310| 69 6e 64 65 78 7b 69 6f | 5c 5f 74 70 61 72 74 7d |index{io|\_tpart}|
|00006320| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00006330| 0a 69 6e 74 20 69 6f 5f | 74 70 61 72 74 20 28 6e |.int io_|tpart (n|
|00006340| 61 6d 65 2c 20 6c 69 6e | 6b 2c 20 72 70 29 0a 63 |ame, lin|k, rp).c|
|00006350| 68 61 72 20 20 20 20 2a | 6e 61 6d 65 3b 0a 69 6e |har *|name;.in|
|00006360| 74 20 20 20 20 20 6c 69 | 6e 6b 3b 0a 52 50 5f 42 |t li|nk;.RP_B|
|00006370| 75 66 20 2a 72 70 3b 0a | 5c 65 6e 64 7b 76 65 72 |uf *rp;.|\end{ver|
|00006380| 62 61 74 69 6d 7d 5c 65 | 6e 64 7b 71 75 6f 74 65 |batim}\e|nd{quote|
|00006390| 7d 0a 54 68 65 20 6e 61 | 6d 65 20 69 73 20 74 68 |}.The na|me is th|
|000063a0| 65 20 6e 61 6d 65 20 6f | 66 20 74 68 69 73 20 70 |e name o|f this p|
|000063b0| 61 72 74 2c 20 66 6f 72 | 20 61 6e 20 52 46 43 7e |art, for| an RFC~|
|000063c0| 38 32 32 20 62 6f 64 79 | 20 70 61 72 74 20 69 74 |822 body| part it|
|000063d0| 20 69 73 0a 75 73 75 61 | 6c 6c 79 20 73 6f 6d 65 | is.usua|lly some|
|000063e0| 74 68 69 6e 67 20 6c 69 | 6b 65 20 5c 76 65 72 62 |thing li|ke \verb|
|000063f0| 7c 68 64 72 2e 38 32 32 | 7c 20 61 6e 64 20 5c 76 ||hdr.822|| and \v|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
